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'>0 GENERAL OVLKVIEK OF OFLRATICM 

^e Dispatcher module's main function is to control program execution 
by switching CPU control to the highest priority program in the 
scheduled list if it is ready to run. The Dispatcher serves as the 
return point from the operating system back to the user. If there 
are no programs scheduled, the Dispatcher prepares for execution of 
the Idle loop under the user map and waits for an interrupt to 
occur. An interrupt is generated by an I/O device, a user program 
request, or an error condition signal which requires entry into 
the operating system for a response. The Dispatcher turns control 
over for program execution until the next interrupt. 

In the process of turning control to a user program, the Dispatcher 
neeas to perform a numDer of smaller tasks. Once it is determined 
that a program shoulo be executed, the Dispatcher needs to check 
whether or not the program is present in memory. If the program is 
not alreaay m memory then it needs to be loaded from the disc. The Dis- 
patcher is responsible for finding an empty partition of the proper type and 
size. If one was not previously specified. If there are no free partitions. 
It would be necessary to swap out a dormant program or a lower priority 
executing program to make the partition available for the load. Then 
finally the user map and memory protect fence are set up before 
executing the program. 

Other functions of the Dispatcher are to set up the partition list 
aders at initialization cf the operating system and to coordinate 
^1^ cleaning up of a program's resources and system available 
memory when a program is aborted. 
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2.0 EXTERNAL CGI.MUN ICAI IGN 

Ihe Lispatcher ccniraunicates with the rest ct the operating system 
through the system tables, oose page communication area, and 
suoroutine calls to/from the rest of the system. There are no 
direct paths ot communication between the Dispatcher and any 
user program because there are no functions in the Lispatcher 
which would be useful to a calling program. 

2.1 System Taoles Keterencea 

2.1.1 ID Segment (Figure 1) 

An ID segment is used for many things by the Dispatcher. Each 
ID segment is linked into the scheduled list by word 0. The 
priority, type, and status are checked to determine whether or not 
the program may execute. The memory protect fence table index 
(hPFI) and number of pages are set into word 21 by the system 
generator or by the relocating loader. The number of pages (which 
does not include a base page) is the numoer of pages actually 
occupied by a program and its largest segment (if any) or the 
override size specified by the user. The size of an EMA program 
includes the mapping segment size (still excludes the base page) . 

The program address bounds in words 22-25 are used by the 
Dispatcher for loading the program into memory. The program's 
disc adoress is in worci 26. If the program is swappea cut, 
the Dispatcher keeps the adaress ot the swap tracks in word 27. 

10 Segment wore 28 is used by the Dispatcher to oetermine whether 

or not a program is using an extended memory area (DMA). If 

this word is zero, no DMA is used. If the word is non-zero, the 

ID Extension is checkec to see if the default Lt^P. size was chosen. If it 

v.'as not defaulted then the program size (from word 21) minus the MSEC size 

is added to the Li:-1A size plus oase page to oetermine 

the partition size reauired. If the EMA size was defaulted, the 

largest Mother partition size, $MCfiK', is used as the partition 

size required (see Section 3.2.2). 

2.1.2 I-'iemory Protect tence Table (Figure 2) 

The Memory Protect Fence table (?MPFT) a table of addresses used 
by the Dispatcher to set the correct value for the memory protect 
fence. 'Ihis address is stored in the base page word FENCE (1775). 
Dits 7-9 of word 21 in the ID Segm.ent contain the index into this 
table . 
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"^1.3 N'eirory Allocation Table (1 inurr <) 

^Sch partition oefined by the user at generation time will have 
an entry m the f^emory Allocation Table. The table starts at 
the^entry point $MATA and extends upwards toward high memory. The 
word :?MNP contains the total number of partitions (set by the 
Th^.^A^'^r -'u f^""^ partition entry (see Figure 4) is 7 words long. 
IhG MAT Link Word contains -1 if the partition is undefined. 



There are 3 different types of partitions: 

1. Real Time Partitions headed by $rtFjR at system start-up. 

2. Background Partitions headed by $BGFF at system start-up 

3. Mother Partitions headeo by i?CFi< at system start-up. 



These, ^ lists are set up by the Generator in order of increasing 

size. The primary purpose for having RT partitions and BG 

partitions is to keep the two classes of programs, RT and BG, 

from contending with each other for memory. There are no 

differences m the two classes of partitions. Mother Partitions are pri 

manly for El- A programs. ^ 

r^iother partitions are defined curing generation by a "YES" answer 
to the prompt "EUEPARTITIOMS?" when a partition is larger than 
the maximum addressable space. Although ^5other partitions are in 
a separate list, subpartitions may be linked into either a 
ther partition (see Figure 5) or linked into a BG or RT 
"^^ither free or allocated) list. When the subpartitions are 
part of a Mother partition, the Mother partition's MAT entry 
word 6 (Subpartition Link V^ord - SLW) will point to the Link 
Word (word 0) of the first subpartition whose SLV« will point to 
the link word of the second subpartition and so on. The SLVv of the 
last subpartition will point to the Link Word of the Mother, if 
nc subpartitions were actually defined but the prompt for 
subpartitions was answered "YES" then the SLVv of the Mother 
partition will point to the Link v^ord of the same MAT entry. 

When a Mother partition is in use, the entire chain of subparti- 
tions IS m use and this is indicated by the C bit being set. 
In this case, all partition status information is kept in the 
Mother partition xMAT entry; i.e.; priority, ID segment address, 
ano Read Completion flag. In addition, the chained partitions 
are treated as a single entity whil;e the C bit is set. Individual 
suDpartitions are not swappable in this case - the whole Mother 
partition may be swapped if needed. 
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The Dispatcher checks fcf empty partition lists at start-up 
(see Section 3.1). It there are no Keal Time partitions then 
the heaoer of the Kl partitions list will point to the 
Background partitions. If there are no BG partitions then the 
RT partitions are used in the BG list. If there are no Mother 
partitions EG partitions are usee unless there are no BG 
partitions, in which case the RT partitions are used. 

The sizes of the largest partition of each type are kept in 
3 words: 

1. $MFTP - size of the largest non-reserved RT partition. 

2. $MBGP - size of the largest non-reserved BG partition. 

3. &MCH^J - size of the largest non-reserved Mother partition. 



2.2 System Base Page Communication 
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ID EXT addr of current prog or 

i'iAT address of current program or 

Pointer to current program's X-Y save area 

Head of scheduled list 

Current program's ID Segment pointers 

Swap delay in bits 8-15 

Last word user base page (add 1 for BP fence) 

Logical address of Resident Library 

Dynamically set address 

bounds for partition 

resident programs 
Dispatcher locks disc tracks for FMGR 
#TrackE system disc 
#Sectors LU2 
#Sectors LU3 

Memory Protect Fence value for user 
Dynamically set bound 



Set or changed by the Dispatcher. 
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3 Dispatcher Entry Points 



^^] 



ALDM Subroutine, used by SCHLDULLR to unlink a partition's 

MAT entry from the allocateo list into the dormant list. 

The calling sequence: 

<A~reg> has ID Segment Address 
J SB $ALDM 

$BRED Subroutine, used oy SCHEDULER to read in program segments. 
The calling sequence: 

<B-reg> has ID Segment Address 
J SB $bre;d 

$DMAL Subroutine, usee by SCHEDULEP to unlink a partition's 
MAT entry from the dormant list into the allocated 
list. 

The calling sequence: 

<A-reg> has ID Segment Address 
J SB $DMAL 

''AXP Subroutine, called by the routine $PEBR when 

a partition is undefined or by the SCHEDULER when a 
partition's "reserved" status is changed by the RS command. 
This subroutine searches the MAT to determine the values of 
$MBGP, $MRTf and $MCHN by scanning each MAT entry for 
the largest partition of the specified type and update 
the appropriate word. $MAXP may have to update more than 
one (and maybe all) if the size words if any of the 
partition lists were initially empty. This is necessary 
because the DISPATCHER would have changed the list 
pointers of the empty list(s) to point to a non-empty 
list. 

The calling Sequence: 

J SB $MAXP 
<return> 
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$PRCN SuDroutir.e, called by DISPATCHLR and SCHEDULI^K to 
relink a partition in the allocated list by 
priority. 

Calling sequence: 

<A-reg> has ID Segment Address 
<B--reg> has new priority 

JSb $PKCN 

$RENT Entry point, JMP there from the DISPATCHEP ano EXEC for 

setting up the Resident Library address in the memory 
protect fence. 

$S^iAP Subroutine, called by DISPATCHER and RTIOC to set up 

the user map. Unused pages are wr ite-protected. 

Calling sequence: 

<A-reg> has length of program to map in pages 
<B-reg> has MAT entry aadress 

JSE $SMAP 

$L)NPE Suoroutine, called by $PERR to unlink partition MATA entries and 
undefine the partition where a parity error is detected in it. 

Calling sequence: 

<E-reg> has MATA address of partition 

JSB $UKPE 

$XCQ Entry point, actual entry for $XEQ where the main 
dispatching algorithm is performed. 

$XEM Subroutine, called by non-privileged drives to set 
up user map. 

Calling sequence: 

<A-reg> has ID Segment Addr 

JSB $XDMP (Entry via Table Area II entry point) 

$ZZZZ Entry point, usee by DISPATCHER and SCHEDULER as the 
head of the program aoort list. This entry point 
is used as a subroutine during the start-up sequence. 
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"4 DiEpatcher's External Tables ana t^ointers 

All of these entry points ^xe located in Table Area 2 unless 
otherwise specified. / 

$BGFR Pointer, BG free list initialized by the Generator. 

$CFR Pointer, free list neader of Mother partitions, 
initialized by Generator. 

$CKST Ualue, start page number of COMMON area, set up by the Generator. 

$t;MRP Address, last word of memory resident program area, 
set Dy the Generator. 

$E1>1DS Value, number of pages occupied by the system, its base 
page. Both table areas. System Driver Area, driver 
partition area. Common, and the first 2K of System 
Available Memory. This word is initialized by the 
Generator . 



$IDEX 



Pointer, ID Extension list. 
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3.0 DETAILLD at.QlKaCAL AStLClS Cf CPEKA1I0K 

This porticn ot the 'iechnical Specifications is a detailed 
aescripticn of major portions of the DISPATCHEK code as 
cutlinGQ in the general overview (Section 1.0). It is 
assumed that the reader has a good general understanding cf 
the R'lE operating system. 

3.1 Initialization 

?ZZZZ serves as the entry point of the initialization subroutine 
which is executea only once during system initialization. 
The routine first sets up the starting address of SSGA in 
$SGAF for the LXEC. Then ^ZZZZ loads the user map with the 
memory resident map registers which were built by the Generator 
in $KikHP . V^henever a memory resident program is dispatched, 
$KiJRMF is used to set up the user map. 

Next, the $ZZZZ routine will set the base page fence so that all 

adaresses Detween 16XX ana 1777 are not mapped. The fence value 

minus one is contained in base page location BP2 (1743) which is the 
acdress of the last available user link. 

A number of system dependent address and sizes are calculated and saved so 
that they may be reused by the DISPATCHER without being recalculated each tin 
Some of these "constants" include the address of the memory resident library, 
the numoer of pages in the memory resident library, the starting register number 
anc the number of registers to oe used for mapping chunks cf EMA to be 
swapped . 

The partition free lists are also checked by the Dispatcher 
during the initialization of the system. If the BG free list 
rjeeoer ( ^bGFl: ) is zero, meaning that it is empty, then the RT 
free list pointer (^^^TFR) is stored into $BGFR. If there were 
no RT partitions then the RT free list pointer will be set 
equal $BG£iR. Ihe maximum unreserved partition size words, $MRTP 
and i?MBGP, will De upaateo accordingly. If the Mother partition 
list is empty the $BGFR pointer will be used, assuming that the 
bG list is not empty since we've alreaay done the check above. 
$MCHN will also be updated, however, if it turns out that the 
BG list is empty because the RT list was empty, then with all 
three lists empty the SChFLULBR will report an error on any 
scheduling attempts. This code is in subroutine LSTIN which is also 
called by $MAXP . 

Ihe last thing cone curing initialization is the scheduling of 

the File ['Manager program, FMGR . The Dispatcher first locks 

all of the disc tracks by saving the numoer of tracks word (TATLG) 

in the FfiGR's first parameter word and then replacing TATLG 

v/ith -1. 
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e DISPATCHFJK'S initialization code is overlayed by the disc 
^ triplets which are built for ooing progran^ loads and swaps 
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3.2 Dispatching 

$XCC (user map entry point, v>XEQ) is the entry point into the 
L1SPATCHEI^ code which performs the allocation of execution time 
to programs. The primary objective of $XCQ is to execute the 
highest priority program in the scheduled list, SKEDD, if 
possiDle. 

First the L I£PATCiiLi;< checks to see if there are any programs 
which were aborted (see Section 3.5). If no programs were 
aborted, then the DISPATCHER checks the scheduled list. If 
there are no programs in the scheduled list, or for some reason 
the programs in the list can't be executed at this time, the 
"iale loop" is executed instead of a user program. The base 
page point-ct-suspension word, XSUSP, is set to the idle loop 
code address and the base page register save area pointers (XA, 
XB , XEG and XI) are set up to use a two-word dummy save area. 
The idle loop code ($IDLE) and dummy save area are located in 
Table Area I so the user map may be used. The base page word XEQT 
is cleared to indicate that no program is executing, the memory 
protect fence register is set to zero and stored in FENCE on base 
page. Then it exits the system via $IKT to enable memory 
protect, the interrupt system and the user map. 

It there are programs to be scheduled in the SKEDD list, the 
DISPATCHER makes the decision to execute a program based on 
the program's priority, status, type, and address space needs. 

If the currently executing program is of equal or higher priority 
then the program in the scheduled list, execution of the current 
program is resumed. If the program in the scheduled list 
is higher, a check is made to see if the program is in memory 
and if it can be executed. If it can be executed the user map 
registers are set up with the program's physical page numbers. 
The program's logical address bounds are set up in RTDRA, AVMEM, 
EKLRA and BKLVyA. The ID Segment pointers are set up in base page 
at XEQT. The X and Y registers save area address is also set 
up at XI. 

Now that the program is ready to execute, the address of where 
to begin or resume execution is determined. If the point of 
suspension address is zero, control is given to the program at 
the primary entry point. If the point of suspension is non-zero, 
control is returned to that address. The memory protect fence is 
set up according to the Memory Protect Fence Table index in the ID 
Segment. 'Ihen control is turned ever to the program by exiting 
through i?lRT which enables memory protect, enables the interrupt 
system, and enaDles the user map. 
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"'^e general dispatching procedure descriDed above is slightly 
^^fferent for different types of programs. 

3.2.1 Memory Resident Programs 

If the scheduled program is a Memory Resident Program, the memory 
protect fence may be set differently since these programs are 
the only type which may reference the Resident Library. The 
Dispatcher will clear the Vi'rite Protect bit from the Resident 
Library pages in the Memory Resident Map by clearing the sign 
bit from those words when the User Map is being set up. All 
the other registers would remain the same as in the Memory 
Resident Map Table ($MRMP) which is never changed. Then the 
memory protect fence is set at LBORG if the reentrant bit is 
set in the ID Segment. Ihis code has an entry point of $RENT 
for access by the EXEC, 

3.2.2 Disc Resident Programs 

If the scheduled program is a disc resident program, it needs to 
be loaded from the disc into a partition which was allocated 
for it. If a partition was pre-assigned at relocation time, 
that MAT entry will be checked to see if it is available or if 
its resident program is swappable. If either case is true, the 
MAT entry will be set up for the new program and will be 
linked into the allocated list of the pertinent type. The MAT 
try will not be modifiea or relinked if its current resident 
the program which RTE is trying to dispatch. 

If a partition was not specified at load time, the MAT entry for 
the partition in which the prc^ram was last resident will be 
checked to see if the program is still resident. The MAT entry is 
first checked to see if the partition still exists. The partition 
may be undefined if a parity error was detected in one of its 
pages since the program was last resident there. If the partition 
still exists and the program was the last occupant in there, 
the partition is set up to be used and the program is dispatched 
there after the user map is built (see Section 3.2.3). 

If the program is no longer resident in the partition or the 
partition became undefined, a default partition list will be 
scanned for a free partition. The default partition types are: 

a. KT program (Type 2) - RT partition (5?RTFR) 

D. BG program (Type 4) - BG partition ($BGFR) 

c. Privileged program (Type 3) - EG partition ($BGFR) 

d. EMA program - Mother partition ($CFR) 
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t'cr FT, BG and privileged prcq rains-, the appropriate free list wi-lJ 

be scanned for the SKicilest free partition in which the program 

can fit. E^(A programs which have a specific E^A size declared will get 

the sfiiallest free Mother partition. But, LkA programs which let the EMA 

size default will take on the maximum Mother partition size ($MCHN) . 

This size minus the program code size is then put into word 29 of the 

10 segment to prevent the problem where a swapped cut program may 

be reloadec into a smaller partition if $MCHN was changed because 

of a parity error on the partition or it became reserved. 

If a free partition is not available, the appropriate dormant 
list (BTD^ , BCDK or CD^i ) will be scanned for a partition with 
a Ewappable program. The dormant lists are a subset of the 
allocated lists (see Figure 6) . The last entry in the dormant 
list points to the allocated list so if the dormant list is 
empty, the dormant list just points to the allocated list. 

Upon finding a suitable partition, the occupant will be swapped out. 
The MAT entry will be reset and relinked, and prepared for loading 
of the oisc resident program.. If no dormant partition qualifies 
for the swap, the allocated list (RIPR, BGPi< or CPK) will be 
Ecanned for the lowest priority program which can be swapped. 
The same proceaure oescriDec for the dormant swap will be followed. 

3.2.3 Disc Resicent Map Set Up 

Once a partition is allocated for a program, the user map is set 
up for the program. If the program is being schedulec initially 
(program's first dispatch) the User Map registers must oe 
loaded by the DISPATCHER and a copy of it saved in the user's 
protected portion of base page (see Figure 7). If the program 
is being re-dispatched, to continue after being suspended or 
after being "bumped" Dy a higher priority programi, the User 
Map registers are set up by copying them, from the saved copy 
in the protected portion of the user's base page. 

A program's first dispatch is identified by the fact that the 
point of suspension word (XSUSP) is in the program's ID 
Segment. The base page register (logical page C) is loaded with 
the page value in wore 3 of the MAT entry. The next registers 
are then loaded sequentially with numbers starting at one end 
incrementeo by one in each successive register. The number of 
registers set in this manner depends on the program type 
or whether or not the program uses COMMOISj. 
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■^^ the program type is 2 or 3, the number 
of registers set sequentially is determinea by one less than the 
value of :?SDA addec to $SEa2. Actually the number of registers 
mapped is one less than i^SDA. The next registers mapped 
(number of registers is determined by $SDT2) have the wr ite-protect 
bit set. This maps into the User Map: Table Area 1, the Driver 
Partition Area, COMMON (including SSGA) , wr ite-protected System 
Driver Area ana wr ite-protected Table Area 2. 

If the program is not type 3, the Memory Protect Fence Table Index 
(m the ID Segment) is checked to see if the program uses any 
COMMON or BSGA. If COMMON or SSGA is used, the number of 
registers set up following the base page register is determined 
by one less than the value in $CMST. If COMMON or SSGA is needed, 
the value $SDA -1 is the number of registers to map in Table Area 1, 
the Driver Partition Area, and COMMON. The user program is mapped 
in the registers following these registers pointing to the 
system areas. 

The next registers are loaded with the next physical page numbers 
sequentially following the page used for the user base page. These 
are loaded into the map registers until the number of registers 
specified in word 21 of the ID Segment have been set up. The non-standard 
MSEC bit (bit 15 of word in the ID Segment extension) is set if the 
program is an EMA program to force the EMA subroutines to remap. 

^^»re remaining registers in the user map will be read/write protected 
to insure that a program cannot access memory outside of its 
partition. ihis mapping is done in $SMAP which is the only code 
which loads the user map to describe a specific program. It is also 
called by KTIOC. 

A copy of the user map is saved in the last 32 words of the user's 
physical base page (see Figure 7). The system's map register for 
the driver partition ($DVPT) is used to map in the user's base page. 
This portion of the base page is not used during the program's 
execution since the system communication area is always mapped in 
on the top portion of the user base page. 

Vvith all of the above done the program is ready for dispatch. 
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3.3 Swapping 

A program is swapped out of memory to make a partition available 
for another program to run. The first programs chosen to be swapped 
are the ones in the dormant list. These programs are the ones 
which have terminatea with either the save resources or serially 
reusable option. Otherwise, prccframs with the lowest priority 
will be checked for swappability. 

Programs are not swappaDle if any of the following are true: 

memory lock is in effect. 
has a higher priority than the program to be scheduled, 
is dormant but is higher priority and is in the time list 
be scheduled in less than the minimum permissible amount 
time specified in SVvAP. 
is I/O suspended with the buffer in the program area. 

When a swap is required, the necessary number of tracks needed to 
swap the program out are computed and a request is made to $DREQ 
for the contiguous disc tracks. The number of tracks is computed 
by rounding up the number of sectors (to next even sector) needed 
for the base page and rounding up the number of sectors (to the 
next even sector) needed for the Ha in Code. The number of sectors 
is then converted to tracks and it is then rounded up to the end 
of a full track. If tracks are not currently available, swapping 
cannot take place and the DISPATCHER proceeds to check the next 
program in the scheduled list (if any). If tracks are available, 
the necessary $XSIO parameters are computed. 

SETUP is the subroutine which creates the parameters for the $XSIG 
disc calls. SETUP guarantees that all calls to read or write disc 
tracks are broken down into groups of smaller I/O requests. Each 
one of these smaller groups of 3 words each (triplets) define an I/O 
request which will not cross a track boundary. The triplets have 
(1) starting memory address of the piece of data, (2) the number 
of words to transfer, and (3) the starting track and sector address. 
These triplets are built in memory overlaying the DISPATCHER'S 
initialization code (code following $ZZZZ). There may be up to 
seven triplets for a $XSIO call (enough for a 32K transfer with 6K 
words per track). The triplets are terminated by a zero. 

There are five separate $XSIO calls, one for each type 
load/swap I/O so that each call can be started independently and 
overlap in time. Disc accesses for each type of partition can be 
completed at different times depending on their sizes. For each of 
these calls, there are triplets tables. The following table 
shows the names used by DISPATCHER. 
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1 Type ol 

1 $XSIO CALL 


Code 

Busy 
Flag 


Triplets 
Area 
1 Terminator 


i Triplets 
1 Terminator 
1 Address 


1 

Triplets 

Area 
I Pointer 




1 RT 

1 BG 

1 ^'othe^r 

1 Et'iA 

1 Segment 


RTSWP 
BGSWP 
CHSWP 
CHSW2 
SGSV^P 


KTF'IP 
BTFIP 
CTFIP 
CTPIP 
SI RIP 


, KTRPA 

' BTRPA 

CTRPA 

CTRPA 

STRPA 


RTRP 

BTRP 

CTRP 

CTRP2 

STRP 





When a swap out is completed, the disc logical unit track address 
and number of tracks are stored in the ID Segment (word 27, SMAN). 



Vihen a program is loadec (or swapped back) into memory 
called using parameters computed by SETUP. ID Segment 
DMAN (wore 26) is used for the disc address if the prog 
swapped out; and SMAN if the program is swapped out. T 
dispatching status in word 5 cf the MAT entry is cleare 
indicate that a program reaa is in progress. The progr 
is changed to I/O suspend via $LIST. When the read is 
any swap tracks are released via J?DKEL and the program 
via $LIST. A check is made to see if the read was corr 
If not, the program is abortea via $ABRT which sets it 
releases its tracks, and removes it from the time list, 
read was correct, the dispatching status is set to one 
program is read in. The program is ready to execute. 



, $XSIO is 
value 

ram is not 
he program's 
d to 

am's status 
complete, 
is scheduled 
ect. 

dormant , 
If the 
to indicate 



When an LMA program needs to be swapped, the swap out to the disc is done 

two parts. The program s code up to the page where the mapping segment 

n5?.^.^^JnxS^^ f^^ ^^? program's base page are swapped out first using the 

ChbWP ^XSIO call. The number of swap tracks needed is computed 

by adding the number of integral tracks needed for the program code 

and base page to the number of integral tracks needed for the EMA 

area. The program is swapped just like any other aisc resident program. 

Note that m the ID Segment word 27, the number of tracks refer 

to ]ust those used for the program code. 



m 
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The EKA area is swapped cut next, beginning at the next even sector 
bouncary following the program cooe's swap tracks. EMA is swapped 
out in large chunks equal in size to the maximum logical address space 
in the user map (up to a maximum of 28K words) . The User Map registers 
from $CMST to the end of the the map, inclusive, define the number of 
pages in each chunk. The chunk is mapped in the User Map, the triplets 
are built and then the chunk is swapped out using the CHSW2 $XSIO call. 
Khen the transfer is completed, the next chunk is mapped and 
Ewappea. This process repeats until all of the EMA is swapi-ed. A 
similar process takes place when swapping into memory. 

The coinputaticn for the number of swap tracks needed must allow an 
extra sector for each chunk. The number of tracks for the EMA 
area is saved in wora 2 ot the program's ID Segment Extension. 
The number of tracks is needed so that the correct number of 
tracks can oe released when the program, terminates or gets aborted. 

v.hen a program is swapped out, the program's map is used. When a 

program, is mapped in, it is necessary for the map to be rebuilt 

according to the information in the ID segment rather than using a 

copy of the user map in the protected portion of base page (because 

it is swapped out on the disc) . Programs which do their own 

mapping must lock itself in memory. Because these 

programs can't be swapped back with the altered map registers. EMA 

programs which have been swapped back into memory will have the MSEG 

registers recalculated and remapped because the program may have been 

swapped back into a different mother partition (and therefore different 

physical page numbers). This calculation is performed by determining 

the number of pages offset from the beginning of the EMA and using 

the same offset in the new EMA. The physical page number of the first 

page in the currently mapped MSEG is saved temporarily in the ID segment 

extension in place of the current MSEG number during the time the program 

is swapped out. Vvhen the program is swapped back into memory, the MSEG pages 

are remapped after calculating the offset into the new partition. The 

remaining pages remaining in the MSEG which are past the end of the EMA 

are read-write protected. If no MSEG was mapped at the time of the swap 

out, the MSEG pages v;ill all be read-write protected when the program is 

swapped beck into memory. 
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3.4 kcther Partition Usage 

It a program (any type) is assigned to a Mother partition or an 
hhh program defaults to any Mother partition, there is more handling 
mvolyeu than is the case with RT or BG partitions. If a Mother 
partition ic used when it is in the free list ($CFR) , each 
subpartition must be checked. If a subpartition is either free 
?.l It "^Sfn^^^^^ ^^ ^ swappable program the C bit is set in word 4 
of the MAT entry to prevent the subpartition from gettii^g used 
while the Dispatcher continues to check each subpartition. if all 
of the subpartitions are either free or swappable, a second pass 
IS mace on all of the subpartitions to perform the necessary 
hr?n' rv ^"^P^^titions are unlinked from any lists they might 
ie "niin^'^rf^ ?^ the subpartitions are free, the Mother partition 
1 r \'!u^'' ^^"""^ the tree list (J?CFR) and linked into the allocated 
list, ihe program can then be loaded into the Mother partition. 

If any one of the subpartitions has a memory-locked program or a 
program which is doing I/O in it's own program space the subpartition 
can t be mace availaole by swapping. All of the C bits must be 
'itT^'r'^ l^l' ^^""^ ^"^ ""^ ^^^ previously scanned subpartitions and 
is examined!' '^ terminated. The next program in the scheduled list 

When a program terminates and it was using a Mother partition, the 
Mother partition is relinked in the free list. All of the 

typriBG^or'^RT)!"^ ^'^""^^"^ '"^'" ^^^ ^'^^ list of the appropriate 

wMch'are''asiian^rt-o%\'''' the subpartitions (set in chained mode), programs 
Te oM?r^n f^^ ^^^!^ subpartition will have to wait if the DISPATCHER 
iTr.::^ ■ .u ^^''?'^^^^ "^^ swapping cut any subpartitions. If a program is 
alreaoy m the Mother Partition the normal swappability checks apply! 

fMotLrpLMMrn^^'^^'^^''^ I'^r" P^i^^ity was in the process of loading 
a Mother Partition ana a scheduled program is assigned to a subpartition the 
loading process IS aborted. Then the subpartition! are released from chainec 
crl.f'''/^^'''''^''u'"^^ the proper free list. A special check is made Ut 
s^pa tft!cn' ''^f'^H ^^^^i^i^^ 1^^^^ ^--^^ to be aborted to free up a specific 
f^^^^ ^ ^^ the partition type is BG and the BGSWP call is busy, the 
abort IS not pertormeo. If the type if RT and the RTSWP is busy, the abort 

til'in^^rrupt sv L^'ff ? * "\'^ "'""' ^^^^^"^^ ^ ^-^^^-^»^ which^could keep 
comDletr Th.n^f5^? ""^ ^"""^ ^^^ '""^y ^'^ ""' ^G ^^11 ^°^1<5 not be able to 
^othef plrtuTon th^^H^.^^'^'T '^ "^^^"^ °"' ^'^ ^^^ subpartitions for a 
c^nttLe^trbrus^a^of S^hef progra^^^ '" ''^' '''''''' "^^^^^ partitions may 
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V.hen a RT or EG program is Echeouled and it is not assigned to d partition, ^ 
a search is made for a partition of the same type which is lar9e enough. 
If none can De found in the free list, none in the dormant list, and none 
can DG found in the allocated list or it contains non-swappacle programs, then 
the dormant Mother partition list will be searched for one which has a 
subpartition of the correct type and size. If a suitable subpartition can be 
found, the dormant program in the Mother partition will be swappe out/ 



.3.'.3 (,Jc<. r I If. 

VJiCnevf.r o. f;>rogran is terini na tec , cither by an EXtC call 6 or 
arjortcr; by the LyLtCin d<:. cauEe c/ <iri error, the prog rain is put 
into the corfT'ant st£t£ and the list processor adds the program's 
ID Segrnent into a list headec by SZZZZ. Ihe linking is through 
word 8 of the ID Segment (the point of suspension save area) 
since the prcgraiii will begin execution at the primary entry point 
if it is rescbedulec. Lverytime the system goes to $XEQ , i?ZZZZ is 
checkec. If it is non-zero the DISPATCHFK performs five major clean 
up tasks. 

First, if the program is aisc resident, any swap tracks it may have 
are released. This may happen if a program is aborted while it is 
swapped out. Vvhen tracks are released by $DREL in the EXEC module 
it will also call the list processor at $LIST to reschedule any 
programs waiting for disc tracks. If the program was an BMP. program, 
it will be necessary to call $DREL twice; once for the program 
swap tracks, and once for the E^A swap tracks. 

Secono, ^.ABKE in the $EXECUTIVE is called to return any reentrant 
memory the program may have. This may happen if a program 
terminates or is aborted while in a reentrant subroutine. If 
$ABBE returns any memory programs waiting for memory will be 
reshceduled. 

Third, the DISPATCHEK calls $V.ATI'; in the ECHEEULEt to reschedule 
any programs which were waiting to schedule (EXEC 23,24) this 

program. 

Fourth, the DISPATCHEP calls $TRRN which calls $ULLU to unlock any 
LUs which may have been locked by the program. $TRHN also unlocks 
any locally locked RWs and deallocates any locally allocated Rhis 
the program may have. Each of these processes may call $SCD3 to 
reschedule any programs waiting for these resources. 

Fifth and last, if the program is a disc resident program and 
it is still resident in the partition, the partition is linked 
into the free list. 
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1.0 CENtPi^L GVEFVILV^ GF CIEKATION 

ahe Mice mcdule ccntrcls ail aspects cf the system's input and output 
operations. It serves as the centralizec I/C interrupt hanoler which 
luentifies the source cf an interrupt and turns control over to the 
appropriate processor. All I/G requests are rfiace .to this inocule either 
oy EX,LC calls from user programs or by $X£IO calls from the other parts 
ct the operating system. The I/O requests are passed directly to the 
appropriate cevice oriver if the driver is available. The I/C module 
also queues I/C requests for busy crivers or for buffered requests. All 
the_necessary mapping and base page communication area words needed to 
perforin I/O will be done by BTIOC. Upon completion of I/O, the next 
request (if any) is started and control is returned to any waiting 
programs. RTIOC also detects and reports errors at various phases of 
the process and performs any necessary clean-up. 
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2.0 1.) lEK^j/M. CCtv[..UMCA*I10N 

RTICC communicctes tc the rest of the operating system through table 
structures, the syFtein's base page coiiiniiunication area, and by sub- 
routines available only tc the system modules. 

2.1 lables Usee oy i^TICC 

2.1.1 Equipment Table (Figure 1,2) 

Each I/C controller anc cevice controlled by the IOC/driver relationship 
is defined by static and dynamic information in the Equipment Table. 
Each EQ1 entry i.<: composed of 15 words. If there is an ECT extension, 
the address of the extension is in LQT Word 13 and the size of the 
extension is in ECT v;ora 12. This table is built by the Generator. 

2.1.2 Interrupt Table (Figure 3) 

A table, crderec? oy haroware interrupt priority, designates the associated 
software processor and the procedure for initiating the processor. This 
table is constructed by the System Generator on information supplied by 
the user in configuring the system. The table consists of one entry per 
interrupt source — each entry contains only one word. The contents of 
each valid entry is tht identifier of the processor. System processors 
are noted by positive values, user processors by negative values, and a zero 
denotes an unused entry. 

2.1.3 Device Keference Table (Figures 4,5) 

The Device Reference Table provides the user for logical addressing of 
physical units defined in the Equipment Table. "CRT" consists of two- 
word entries corresponding to the range of user-specified "logical 
units," 1 to n where n is less than or equal to 63 (decimal). All word I's 
are intone table followed immediately by a second table containing all DKT 
word 2's. The contents of DRT word 1 for a given logical unit is the 
relative position of the EQT entry defining the assigned physical unit, 
in bits 0-5, and the subchannel of the EQT entry to be referenced by 
this logical unit number, in bits 11-15. The LU lock flag (the resource 
numoer being used for the lock) is in bits 6-10. An unassigned unit con- 
tains entry value of zero. 

DRT word 2 contains a flag (bit 15) indicating whether a device (lu) is 
up or down (0/1). if a device is down, then all I/O associated with the 
device is stackeo on the major LU (first LU tor this device in the DRT) 
in oits 0-14 of DRT word 2. It the downed LU is not the major LU , then 
bits 0-14 of DRT word 2 will contain the LU number of the device's major 
LU. 



Ccrtoir ]coic£ui. unit nuuoeri: rre ;)t;j i;,oi^er t J y a^.sivjneo t.c tciciliti.te 
Eystea., tr.er c,ric systcMii Eur.porL l/(. cr^erci I ions. These ate: 



1 1 



iUc(;e 



- System "lele typewriter 

- tvysteii, Lisc 

- Ai.:xiljary Lisc 

- "LtancJarc*" Output Urit 

- " 1 1 1: Y\ ci.a r G '* In p u t Unit 
~ " b I c: r: c ci r C: " L. i s t Unit 



b3 



A £ E 1 g n e a b v u s e r 



. 1 . 4 



Track AsFigriiiGnt 1..aDle (Figure 6) 



The 'IP'i: is a teDle cescribing the availability of each track on the 
Systeui Disc ana /iuxiljary Disc (if included in the ccnf iquraticn) . The 
TAT is ordered by track nurnoer and consists of a one- word entry per trac 
The value of an entry defines its availability. 

- Available for assigniment to user or system 
IGOCOC; - Assigned to system (or not available)^ 
7 7777 - /-ssiqned globally 

7 77 76 - /vssiqnea to file management package 
<1L Segiuent Address> - The ID Segment address of the 

user program. 



assianed 
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lU Switch Taole 



RTIGC will scan a two entry table for each call made for 1/0 with the 
IJATCtJ flag set. If the request LU aoes not refer to a disc and is 
fcunc, the LU will be switched to the table definec, LU. This table will 
give ar LU to LU ttansfcrKi for BATCH programs only. The table format is 

LUT $LULU 

. $Lur.u j:.fc -b> 
};lp u 
. ccn -1 
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Locn cctivr wcro i; ret, v.iti- Lhc i-cdres^ Li' in the lew b~I;itE and the 

^■^ ^^ ce u£:co in iti i/lacc m the high b- hits. Uhere inciy Dc up tc ^ 

c-trier. in ony crccr. iriL tcTitle will be generated by the Generator and 

^j Cri ifxritor. 



/luintaired cv t Is e 



.1 



river i£^rtiticn ^:£:p laole (Figure 7) 



Lacau/. will have associatec with it, a two-wcrc driver ma- table entry 
wiiicn indicaLn;£. whether the ariver for that EQl is in the System Driver 
^'rea (:;da) or ie. in a oriver partition ana whether the driver (if it is 
^LA) aoes its own jappinc; cr not. If the oriver i£ in a partition, the 
entry contains the Lfartin^^ paae nuinber of the partitioii.' Ihis page 
nunoer is put into the appropriate system map cr user map reqisters to 
i-ap in the criver. 



m 



^ne second ^woro ci each entry is usee when I/G is started on the ccrres- 
pcnoing driver. The siqn oit ct the second word indicates whether or not, 
1/P is oeing acne for a jrea-.cry resicJent prog rare. a he were is zero for 
s y £. t e n. I / . 'i h e 1 c w 1 i, o its contain the d a g e number of the user's physical 
case page if it is a partiticn resident progranu Ihis wcrel is used to 
save tiiiie cr setting ui.' the proper iiiap en orccesslng interrupts. 

^•^ LI'ICC E:ntry feints 

VLITL Value - non zero if requests arc queued on bit bucket 

^'PLLC Value - lew Duffer limit 

U.:Iul Value - high ouffer liinit 

l^^^^ frtry point - junips here from $C1C for interrupt processing 

i?LKLO tuLrcutine - check if dgJow the buffer limit on the current 

Lallinq Sequence: 






Y L V L Q 
vtiv^- 



J SB ^Ci.\LO 
fntry point -criver completion return 



o r 1 V e r co r, t i n u a t i c n r e t u r n 
enter the driver's continuator section inust 
.pE since drivers return via the acaress 



Lntry point - 
The cooe tc 
DC in all ii;< 

resulting froHi a subroutine call. K'UGC will do a JMP 
^UCOK when ready to enter a oriver's continuator section 
e r jiia ].> . 

Lt'l entry nuinber into the actual LQT 
to set up the case page EQ'l pointers 
frora ^iiCIC to skip the CLF and LIA 



unaer tfie 
Gubrcutine - converts an 

acaress anc calls ^LILQ 
Entry point - juaiips here 

in iillCC at ^>CIC. 
Lntry point - juiirps here 

v; h en a c e v i c e t i Vue s o u t , 
Subroutine - used l(. s. i 

of an 1/0 operation on a 



froni the system clock routine 

''I^ ^- !;ii'V(;n; u. .^elay initiation 
timed- out EOT. 
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Call ir.q 
• 1 1.. A 1 



€ V' lie f ■ C C 



( •-' 



r:;^^ ;aiut-....cLc.s ci the dummy LCi usee for oit bucket operations. 

'■'""■ ^f^'i':"^:^^''^^'^^ r:,5ppin9- ^iystcm stctus is saved here when 

vCl^.. IE GLtereG. It is useo Dy ^PEFR. 

"'■'■^■^^■' '^!:i:^:i;^j!^^ - -^t- ^P^he rnap registers for entry to a driver 

-ft<.r the Dasc pcge EOT pointers are already ouilt in base 
^nrivt^l'' -^^^-^^^ 3.3.S for details of $DKV^^ Called oy FTICC 

Celling i::equence: 
(EC'I. 1~-lC^.15 aireacy eet up) 

<retcrnL> ;wreg ana b-reg sarne ascn entry 
E-C neeo to enter ariver in Systeui i-lap 
L = l neeci to enter driver in User Me.p 

tVr^'f ^■^^^outine-zets up the base page £C'i pointers L011-ECT15 

vxe-^u Entry point - to set an LU or LQI down. This orocesses any 

. operator Di^ request (froni the scheeuler's inessage 
processor) that a aevice (LU) or an I/C slot (EQT) be down, 
it first Gotermmes if an LU or EQT is being set down. 
IE dn LCx IS ioemg set down, it checks the validity of 
fhr rr^ via the <10Dt.S> subroutine. It also determines if 
tne U.1 (i/c slot) to be set down is associated with the 
system console. If either error condition exists, it 

S'ni''!^Ji''^''' ''''''''''' inessage ana returns to th^ Scheduler 
inoGules message processor. Otherwise it uses <XUPIO> to 
£^et all Gowneo LU s on this ECT into the "up" state and 
uses <!?Ui^LK> to down the EOT by setting i ts ' availabil itv 
inoicator (bits 14^15 of EQT 4) to 01. After suspencing in 
cne general wait list any programs queued making unbuffered 
i/w requests, it returns to the Dispatcher. 

11 an LU (device) is being set down, it first checks the 
valioity of the LU and whether the user is trying to 
GOwn LU I or an LU pointing to the bit bucket. If one 
oi these error conditions exists, the message "INPUT LKLOR" 

proce-or """^f ^Eh^'i'n^^ ^^ade to the Scheduler module's message 

pioccosoi. if the LU s tQ:1 is down, then the LU is simply 

markec down (set bit 15 DRT word 2) . if the EQT is up, 

then set the LU and all other LU's associated with the device 

aown ana relink any I/O on the device's major - LU (£^8? 

LU for the oevice in the DRT) . Return is made to the Dispatcher 
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i?ICi^C tntrypciiit - All EXEC calls tor 1/0 relatcu reques^tsj 
are picceLsec re re. 

i^IOlji:- Lntrypcint - 'io make an 'LQl available again. This 
processes any operator request (from the Scheduler's 
message processor) to set a oevice "UP". It first ciiecks 
the validity cf the EQT nuraDer of the device to be set 
up via the <10DNS> subroutine. If valid, it next 
scheaules all programs v\/aiting on a downed EQT or LU. Next 
it uses <XUPIO> to set up all LU's associated with this 
EQT. <XOPIO> will use <$XXUP> to relink on to the EQT 
any I/O found en a downed LU. If the EQl ^as down or 
availaDle, the "up" processor will reset the EQT "up" 
ana return to a point in <IOCGM> to start the next request. 
Otherwise, return is made to the Dispatcher. 

^Ih'x Lntrypcint - Common exit point from the system back to 
the user. $IRT is a routine used in exiting from the system 
back to the user program. It does nothing except clear the 
ineinory protect flag in a ncn-pr ivileged system and restores the 
registers. In a privileged system, $1E1 clears control on the 
privileged interrupt card so that when the interrupt system is 
reenabled for all devices, all devices can interrupt. 
Ihe exit from $IPT Dack to the user prograiii is a 
"user map enaole end jump" instruction. Note that $IRT always 
enables the user map. The map is loaded before 5?IRT gets 
control. 

ipSYKG Subroutine, system error message output. This routine 
t-rovides for the output cf system messages and error 
diagnostics en the system console. The routine m.aintains a" 
"rotating" buffer area consisting of five 10-word blocks; 
i.e., the maxin.um length of a message is 18 characters 
(9 woros) plus 1 v;ord preceding the message which contains 
the character count. 

$UWLK Subroutines, used to unlink I/O requests from the 
current EQT I/O request queue. This is called when an LU 
is set down and all of the I/O for that LU is moved to the 

L U ' s oo^ w n a u e u e . 

$UP Entrypoint - jumped to by $UPIO from Table Area 1 via SJF 
'ibis entry is used by drivers to automatically "UF" the EQT 
anc is essentially the same code as $IOUP, 
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•; ^L.■ IC L ubrcut mt; 
tc PC rfcri:. 1/C. 



-• caiJtci i.y the opcratiiivs cviU;eui ii^oouieF 



AXUi' ruDrcutiTG - takes an I/C queue and pcsiticns the 
i/L requests (Dy calling the Llt.K subroutine) in the current 
LwT queue acccroing to their priority. it returns a flag 
11 en I/C operation should oe initiated. 

Calling bequence: 
A-reg is LQ'l address of old aevice 
B-re9' i£ acdress of first stacked I/C requests tc 
ce linked onto the current EGl 

J S b ^; 4 -A U F 

B-reg is on return 

A-reg is the address of the head ot the current queue 
vith an I/C operation to be initiated. 
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lase raqc lc.^ mun icct icn 



XI 


EOIA 


EQTji 


DKl 


LUMAX 


I MBA 


IHIIG 


lAT 


KCYt'=D 


LQTl-EC'1'15 


CHAt; 


TBG 


SYETY 


RQCM'] 


PCK'IN 


EC Pi~KCF7 


XEQ'I etc 


CFATM 


Dut;MY 


TATLC, 


TATS L 


SECT2 


G EC1 3 


LGOTK 


LCCC 


I'lV'i EL 



These are all Iccatec in the System Communication Area cf Ease Page 
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li tr.c Litr ,,.,: it:, rcecec, crtiv tc tl-,e iniver'!^ 
ccr.tinur.tor iccticn is enterea oy a Jtn' $UCCIv. if the 
-yote,.: ;. c^p If usee, the simt-le J£B t,l will be cone. 

cc,Lut^M-r''if''^,''''"°*''^i' '''''' P'^rformed concurrently with program 
the'tr;. 'rl. :>:'" ''"'^■■"^'"^^^"■- ''' P'^ogran, is I/C sur.pendec until 
rulrut rrlCf -'. ''-^^'Jti"' ^^^ cortipletec unless automatic bufferinc 
l^^ 'rror^^l^ '.o.- pcci lec Lor the device cr the reques-. was a class 
:.C:'lf'l^ -'" '^'''''^^ ^'-"^ ^^^"^^ the Duffer is raovec to systerj availacle 
.i.fcK.oiy ur.o the user prcgcam is not suspended. 

the^rcrL"''ie'%.'f /■"'•'■''"?"• ^■•■^"' ^"^^ -^""^ i" the user program area 
^«^li'-t1. IS r'ot cv..appecie. If the suffer is in coinrr.cn or system 
clr-iff "'^f'^y' the progra.;, is swappaole. ;> user may call KEIO tc 
-eve his Duffer tc Gystem available wen.ory and make the 1/0 call. " 

The user prcrjram ir^aking the reouest is scheoulet in,r>,eci£tely if return 

^';' '"' ^^ "° the current request but the DMA bit is not set in the hQl. 
^•2.1 User 1/c hecuests 

ce--'irn^.y"r'r?"'°^'rr" '^^■^':'"^'1'^>= to ^ICKC after initial request pro- 
cc..inr, uy tAlf. Sioii:. pertorras validity checks on the request 

ccnd' ticr^ 'I'r r1 the addresses of the referenced EC'I entry. (Lrror 
ar ■ Icra h ° ."^^'''''-^''''^ t" ^^^^="^0^^= l«ter.) Ihe buffer acdress 
prctectL ,c".erv ' 'n^. 'T/'^^^^'*^-^°'^ ^"P"^ requests to insure that 
1/C 'ulfrr' Tr lli m"'^ ^Iterec curing the transfer. Ihe last page of 

ir^uro V [T/^, '"'■' ""' ='^^='^^<^' f°t read/write protect status to 

insure v.,iio intii.ory accesses. 

l.-isc 1/C fee lies ts 



If 



,rc-,r~ t .r ' ■ /" e^vice IS a oisc unit, the request is cnecked to . 

c -i ft i-^-^meters are r.upplied. If the disc Lt3 number is either 
tr^U .^ r^"'"'^'-"' "'^^tirnally checked tc insure that the disc 
-; trirr'rrn-l'f '""r'r''lf """^ ^'''^"^ °"^= that the transfer does net exceed 
or ' . ^f ri':'r^\ "■ th^ request is output, a referenced track on LO 2 
?r .^e;"; t'tddre.^ c If"' ''•"•( ''''' P' entry address .oust eoual the 
or ; ol ■ :*] trac- ' "'" ""^^'' "'^ ^'"'''^'^ ^^ ^ loao-and-gc track 
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iGcucHtc invclvina Lulfere;C' Cutput cnc C'loss I/C 

If a Urite or Ccntrcl recuest references a device for which the user 
Gesignateo 6u tenia tic iouffering, a iolock equal to the Duffer size, plus 
control inicripa ticn (5 worcs), is requested for allocation in the system 

availacle ireii.cry area. (Gall to $/jLC.) A Class I/O request is 
also mcveo into Evsten' availacle rnernory. 

if the block cannot toe allocatec, the user program is suspenc'^d and 

linkec: into the memory suspension list. (The memory processor ($RTN) 

will cause the user proorarr tc oe scneduled as soon as a block is 
released . ) 

After a olcch is allccateq, the control informaticn (CCNVvD and buffer 
length), priority ano buffer (if a Write request) are moved into the 
Dlcck. ihe first vvcrd of the block is used for linking into the device 
list. (See Section 3.3.1.) 

tvcrmai User Beaursts ano RCIO Recuests 



Ibe parameter £ of a user teauest (which is not buffered as above) are 
moved into the S~wora temporary area in the ID Segment of the program. 
Ucrd 1 of th(i 11. Fognicnt is usee for linking into the device list. 

(See Section 3.3.1.) 

'ihe user pi^oaraiii is suspended with a suspension code cf 2 (I/O suspension) 
Ihis is also cone for an I^EIO call. The only difference is that the 
buffer accress will point to system available m.emory instead cf the user 
area. The sign bit of the buffer address in the temporary words of the 
IE segment is set if the buffer is moved as the result cf an $EEIO call. 
This is to teJl the system that the driver must process that I/O request 
u n Q e r the sy s t e m m a p . 

Error Conditions and Diaanos t ics 



Detection of the following error conditions causes a dignostic identifying 
the error type, a program name and location of the request to oe printed 
on the system teletype. 'xhe program is then aborted '($ABRT in EXEC). 



^ ^'^ '''-' ■■' - ^ i ^- 1 ' ■ f- i c i e r t ii . c 1 r eq u t s t ;,;;■ a r a r.ie t e r s . 

^■■'- Xllc^ol iGgici.l unit #, cr lesE than b paraiLetcrs 

vvitfi iv-ijit set, 
'-3 Illccal HCT reference, select ccce ~ U. 

^''^ User uuffer violates Eysteiri (cr Real-Tinie) Douncary, 

'•' - Illegal ciirc track or sectcr # in cisc request. 

i'^> .V'.rite reference to protectee track. 

^''"/ i: liver rejectee the request as illegal tcr the 

cevice (unLufferec requests only) . 
^^^' J.:i£;C transfer exceecs track t)Ot'ncary. 

iH OverfJcw.of loac-^ard-go area. 

i^> Class (..,, LI occur rec and one GEl call outstancing on 

tnis class. 
11 lllecjal user n;ap request in System Driver A;^'... 

:'.'-'- System I/O' [■;eGuest frocessor <$>;i:.;iG> 

/, privileged entry is prcvioec at i;>x::.lC to allow mocules of Real-Tiiiie 
LxeciM:ive to call for I/C operations without incurring the cverheac • 
ano proccourcG invclvcc vith user 1/l requests. No error, checkinq is 
e'CrioriLer , the request is linkec into the appropriate I/C list at".- 
priority of zero (highest priority) except that disc request: niay specify 
a ^Tiority, arc control is i,n;iTied lately returned to the first word 
1 o 1 1 c ',v i n c: ty.r, r e q u e l t . 

F.equest i;ori;i3tp /'• syste;..i 1/0 request differs from the user I/C request 
in tcriiict are power. Coecif ically , a systen'; disc call can specify a seri- 
or. trar:sfers to be perfcriried before the next operation is initiated. 

,:■■ ccrapleticn address car De sir.ecified for operation of an open suoroutine 
at the era of the cperaticn. 'Jhis facility, is only availanle to system 
routines ar.c is useful lor resetting flags, etc., oecause an I/C 
operaticr: is always buf.ferec to the system. P.. zero ccmpletion 
acdresc indicates absence of a completion routine. 
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3 


Dl r 


4 


i:.iL-P 


5 


OC'i ^ 





DEF ^ 


7 


DEC ; 


Ci 


OCT : 


t he 

X. l_ _ 


Eciiue fielc 



^XSIO 

< 1 ocj i c c. 1 unit d u ra be r > 

<corripletior rcutine address> cr 

<liEt pointer wcrd- set by "LINK"> 

^control intormation/recuest codc> 

Duffer address, or location of disc contrcl> 

Duffer length cr <disc request priority> 

map v^ord 



format as the control word in 
except that the reauest code replaces the logical unit. 



a user request 



:"■'"'' T^.r ' ''^'''' '-^ ^^^ request is tc be processed under the systein 
^'ap. ..t the user iPcp is tequireo, the word 8 must contain the ID segment 
ciuaress ot the prograni tc |be described. Vvcrd & is lOCOOO (octal) if the 
recu;est is to De processed under the User r^ap as it is curren tly-withou t 
ciiange. ..'ore b is set to an ID segment address with the sign bit set if . 
i..ocifiea user n,ac is useo (e.g., when the Dispatcher is swapping a portioi 



Also, the ip^.SIO call uses the same routine, DEIVR, to set up for and then 
enter the driver. ^ tiien 



^^^o ^f'^f^^^ ^-f i-^equest: ..era b points to an array containing "n" 
-rrt, i/i'^'-i : ^'^'^^^'^^trng the buffer control, for each transfer. 
array of triplets is opennended and terminated by a zero word: 

\vord 



The 



LLC 
OCT 



<ouffer address> 
<Duffer length> 
<track/sector#>> 



n GC-j G 
^jcro 7 in this case is 



used as the priority of the request 
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1 r i t i c I: i c r j o i 1 / C; i . (: c- l. t; 5 t s 

. 1 i/0 x">eo u.f:=:. t £ 

'ii c ccntroi wore, is set up as icllow£: 



i:;| 14|lui 121 111 ICI l.| 01 71 61 5| 

<i> Ki'UL 2> J <a;^ii,Gi ihFO I 

I I I Li. I I 



I 3 1 2 1 II 1 

<S'L!h 1> <KC > 



i^C ~ li£cr request (1 = kL/\D, 2=H'vKI'JE, 3=C0KTfvCL} 
v.ulI - iiiyii 2 cits ot suDciiannel 
.■■■[.11:2 -- Lew 3 i.)it£ Ox subchannel . 

i;iv. - :::et only for a disc request. Inoicates if aisc is 
system auxiliary, or peripheral 

T - t.equGEt type identifier 

UO ^ Lser (Normal Operaticn) 
01 = Laer (Automatic Buffering) 

10 =^ Eysteu; 

11 = Ui.ass I/C 

/■•Iter tlTG necessery legality checks are mace, the request is 
linktc irbc tbe queue for the referenced 1/0 device. "l£ the 
request ir; s. rcrmal user request, the parameters are set in 
tue temporary storage area of tne ID segaient. If the request 
cJass I/C or the device has autcinatic ouffering (output or 
ccntrcl only), the request parameters are ifcveo into systen: 
i-i V c,; i. 1 a ij ]: e m e /ac r y , ■ . 

i/w requests are linked in a list for each device accorcing' to 
■priority. , '.ihe requests are user (ncrinal) , user (automatic 
output i^uf ferine) , class I/C, or system. Identification of 
the request type is the code in oits 15-14 of tne control word 
in eacn request format. This {:ield, the "T" field, ioentifies 
the rec^uGSt as: 



(K) User (normal operation) 
u 1 u f • £. r ( a u t oitia tic d u f f e r i n g ) 
Hj c:y£te.i;i 
11 Class I/C 
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1) 



scr (i:cr..£i 



r a t i c r ) 



ir.e t-siranictG rf: ircm the reo,ue£t are stcrec in the temporary 
area ci the proara::; ID Segment. The link word of the 
segirent is usee tc certain the linkage for the I/C list. 



uora 



Contents 



1 linkage word 

2 l>ccntrcl inforaiaticn, request code 
-3 i-juffcr cddress or contrci parameter 
^i Diiifer length 

5 disc track # or optional parameter or zero 

6 Gi£c £:tE.rting sector ^t or optional parameter or zero 

7 prog r air priority 

rem a inc er 
.of 

IL Segiient 

2) user (Automatic Output Buffering) 

>veque£tr ef thi& type are constructed in the system 
a V a i 1 a c 1 e r; v e n.c r y a r ea . 



herd 



Contents 



linkage v^ord 

T,ccnt^rol informatior, request code 

priority of requesting progran. 

totcl ijlock length in wcTds 

user Puffer length 

v/crd 1 of user Duffer 



n+5 



word n of user buffer 
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If the device or ccntroller is "down" or "busy", no action is taken and 
return is made to the caller. If a ema channel is required but no 
channel is available, the "/^V" field in the ECT is set to 3 (waiting for 

D^:A) , one is added to "r:.t'i^,CF" for the number of devices waiting for DM/^., 
and return is made tc the caller. 

If the device is available (and a Df-A channel is assigned if required), 
the device time-out clock is set from the clock reset value (in"EQT14), 
the subchannel is set into EQT4 (from EQ16) , and preparations are made 
for calling the driver. DRVMP is called to do the driver map set up 
(see Section 3.3.4) . If a DMA channel is being used, DRxVR also sets 
up the DI-'A map by copying either the System Map or the User Map into the 
correct pert map'. Note that the. DMA map does not need to be reloaded 
until it is reallocated. If the driver needs the user map, that map 
must be reloaded before each entry into the driver. 

3.3.4 DRVMP 

This code is called tc set up and enable the necessary maps for the driver. 
The preparation for setting up the maps for the driver call includes 
checking word 1 ano setting up word 2 of the Driver Miapping Table 
(figure 7). The first word in the table is found by using the EQT number 
to index from $DVMP. The second word is found by adding EOT# to the 
address of the entry's first word. 

If the driver is in the System Driver Area and does its own mapping, 
the driver is always entered under the System Map. NOTE: $XSIO calls 
must have zero in the eighth parameter, no checks are made. 

If the driver is in the System Driver Area but does not do its own 
mapping, the T-field of the request is examined. If the T-field is 
zero (normal user) the program must be privileged (type 3) in order to 
use the unmodified user map. The second word of the driver's Mapping Table 
entry is set to the physical page number of the program's base page 
(first page of partition). Any other types of I/O requests or types 
of prograras requesting I/O for a driver which doesn't do mapping and is in 
the System Driver Area will cause the request to be rejected (a'program 
will be aborted with an 1011 error message). NOTE $XSIO calls may not 
be used to call a driver in the System Driver Area if the driver does not 
do its own mapping! The ICII error message will also be issued in this 
case, the request will be rejected and returns control to the XSIO caller. 
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If the driver is in a driver partition, the T-fielc is checked. If 

the T-field is 2 (system request), the eighth word is checked to see 

if it is either a diFc prograrn load request or a special disc I/C 

request. If the eighth word of the $XSIC request is 100000 (octal), 

it is a special request which specifies that the current User Map 

is used. The special request is used by the DISPATCHER and by the recon- 

figurator. If the eighth word is a positive value, it is the ID 

Segment address of a program to be loaded. The program's map is built 

Dy $SMAP. If the eighth v.orc is negative, it is an ID segmert address 

with the sign Dit set. ihis form is used by the Dispatcher for swapping 

channels of IMh. A special user map is kept in the user's prelected 

portion of base page jrst Delow the normal copy of the user's map. The 

physical page number of the j.;ase page is set into the second 

word of the Driver ^'apping Table entry is set to zero. 

All buffered user request and class I/O requests use the modified system 
map. If the T-field indicates that it is an unbuffered user request, 
the second word of the Driver tapping Table (see Figure 7) is checked to 
see if the request was made by a Memory Resident program. If it was, the 
MR bit of the second word of the Driver Mapping Table Entry is set and 
the modifiec Memory Resident map is used. If it was not a Memory 
Resident program request, the first page number of the program's partition 
is entered into the secono word of the Driver Mapping Taole entry and 
the modified User Map is used. 

V«hen a driver is in a driver partition, the map under which the driver 
is entered must be changed to address the physical pages of the 
partition. The modified map is saved if it was a user map (other than 
when l/C is being done by a Mem.ory Resident program) that was modified, 
'ihe purpose of this is to save set up time on each continuation interrupt. 
The page numoer in the second word of the Driver Mapping Table entry is 
loaaec into the System Map's driver partition reaister ($DVFT) to map 
m the user's^physical base page (see Figure 8).^ The copy of the 
modified User's Map is then stored in the top portion of the physical 
base page via a cross-map store through the driver partition register in 
the system map. 

3.3.5 $DRV7n Subroutine 

^hen a driver needs to be called as a ne^ult cl an interrupt (continuation) 
$DRVM is called to check the Driver Maopinq lable entry. The first word 
of the entry determines whether or not a driver partition's pages need 
to be set up in a map. ahe second word indicates which map to use. 



If the second wore is zero, the System Map is used. If the driver is in a 
partition (Word 1 has the partition's starting page number) the System 
Map IS moaifiec to address this partition. if the driver is in the System 
Driver Area, no mooificaticn is necessary. ?'DRVM returns with an 
indication that the System iiap is to be used (L = 0). 
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iic r.£ cc nc- were. \ :;c 1 h.i 

'Ilk: currera. l;£(. r K!aj 
Ijcer i <;.p ji ict up Vvith the 
iticr rcqirterr ere cxt 



ir 



i:;n DM: fct the nO:.,ory iariiu-;nt ^!clp 
i;: i:avcd in a buifer (^VUSK) . Then 

i^'iCMiicry Resident h:ap and the driver 
ip a c cor Cling to were 1 cl: the n^apping table. 
oii iriGicatiori that the User f.ap is needed {t:>l) . 



Ye Eeecnd wore 

up arc i£ £ 

I savoG the current 



ras a page nuiroer, the necessary user map is already 
up arc i£ £torec; in the last 32 words ct the indicated page. 

user map in SVUSF. Regardless of the driver's 

Cl; residence, the User J>.,ap is specified (l = 1) . 



that the user j:;aD i s sevec 



s not already ruappec 
i c a t e ni a D c , 

& $l:iri;. ruoicutire 



in the 



a r* o. 
user 



;et up to the required map only if 
ii;ap. This saves time in setting up 



This routine is callec en every return from a driver. It checks the 
flag I:v^■.,P5■ to see it the user map was charged. If it was, HSTUS reloads 
the user majj with its original contents (saved by DWMP or i^DRVM ) and 
clears fiaq l'VI^IPS. 
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O.J 



1/C Irivcr Initicticn ivtiturn 



Upon returi) ironi the orivcr vKLi- is called to restore the user msp 
(ii it vvdf cbancec) to it£ £tctus prior to driver entry. 'ihe driver 
returns a ccce to Liavn incicating whether the operaticr was accepted 
cr rejected c.nc the cain:e cf the reject. ^his code is in A on return 

C - cperation succeGsfully initiated 

1 - Eee.6 cr v;rite request illegal for device 

2 - Ccritrcl request illegal or not defined 

3 - cquipiiicn t maliuncticn or not ready 

4 - operation suqcessf ul-imniediate completion 

5 - criver requires a Lhl. channel for this ope ration 

6-5 9 - Keservec for HP RIL t-ystem iiiodules arc system drivers 
GO-9 9 - Keserved fcr user drivers. 

11 the ccce is 5 a DMA allocation is attempted and if successful, the 
driver is reentered witht he request. 

If the operaticn was othervi'ise rejected, CiaVK returns to P+2 of the 
call with the reject coce in ?■ , 



If 


the code in /• 


rec 


dy) . 1 


he cevi 


cha 


rnel wa 


s alloc 


and 


ICCf' i 


s exite 


con 


pie tier 


rout in 


1, 


2, 4, 6 


or gre 


If 


a zero 


is r e t u 


device int 


errupt 


Scf 


eduler 


mo c- u 1 e 


executicn 


tire. 



is 3, the device was found to be unavailable for I/O (not 

cc availability indicator is set to 01. If a Dii'iA 

a tec, it is released. The "NR" diagnostic is printed 

d either back to $XI'C) in the Scheduler cr to the 

L specified in a system request. If the code in A is 

ater, control is transferred tc subroutine <ILLCD>. 

rred, I/Cj was initiated successfully, with subsequent 

expected, and control is transferred to $XEQ in the 

t c s Vv' i t c h: to the n ex t 1 o we r pr i o r i ty w h i ch requires 



j.J. 6 Jj;',/ CI-viLnc J. /\Jlccc<Licn 

'ire tv/c Lir, cnanrels are cy naruixelly allocated to the hich-speed and 
£ynchr:oncuE devices idertifieU to RIICC (bit 15-1 of word 4 in the EQT 
entry). 'ihe c^ssig niriGnt process consists of setting the EQT address 
oi the device in the LIjA ciiannei entry in the Interrupt Table and 

Letting the channel nunujer in the vord "ChAW" in the Communications 

J. '. r G' a • 

/^ driver with its. LOT DMA. bit not set may also request a DMA channel by 
settincj A-5 and returning tc the systera at initialization of the 

1/0 request. 

It more than cne device is vv^aiting for a channel, the order of priority 
I'oj. ossignnent is the order of the Positions in the Equipment Table. 
There are t^vc exceptions to this scheme: 

1) If the first entry in the EQT is waiting for a DMA, the 
channel is assignee to that device, which is assumed to be 

the systeiu disc. 

2) If the first entry encountered (other than entry #1) just 
released a DKA channel, then the next Icwer priority device 
waiting for Lhh is used. Ihis allows for a "switching" 
operation in the allocation of a DMA channel. 

special prccessinc, is requireo by any I/O ariver which uses the interrupt 
en a L;hi\ channel to . perf orni data transmission with the device. A 
software flag ipust be set after a DMA channel is initiated tc indicate 
that the channel is active and that a completion interrupt is expected. 
The setting ci this flag is to set Eit 15=1 in the Interrupt Taule word 
cor resocndino to the DM, channel: 

Io!TDL(l) - channel #1 (location 6) 
IN1EL(2) - channel #2 (location 7) 

'Ibe address q1 I.W1i:L is contained in the word "IKTBA" in the Base Page 
Comrfiunicaticn Area. ivhen i-.it 15 is set, the rest of the wcra must not 
DC a], teree. This operation must be done only if DUMMY is non-zero. 
^^'Tien a f/stem has privilegec drivers, i.e., DUMMY = 0, control is 
cleared en octh DMA channels every time an interrupt is processed through 
CIC - in order to let the privileged interrupts be the only ones "on". 
^hus it: a criver needs that DPlA interrupt, it must set bit 15 in the 
appropriate wore. $IRx checks these words and if the bit is set, it 
reenaoles tne VI- A interrupt. 
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^ . 4 CciTipl.,ticn cj. I/c 

irc rcturr Dcint Dy c..n i/(, criver (from a call by CIC) indicates the 
ccntmuaticr cr ccnipie tier, of the I/C operation. In BTE IV, the user 
(r.ap IS restoreo li it vies mocitiea for driver entry. FSTUS i^' the 
routine called tc cc this. ' 

1. i'^eturn at {P4l): Ccmpleticn of the operation. CIC 

transfers directly to the IOC completion 
i^ecticn at "lOCOM. " 

2. KGturn at tF-J2): Continuaticn of the Operation. CIC - 

restores all registers and returns tc the 
point of interruption, with the exception 
of special processing which must be done 
tor operator attention: If the flag is Base 
Page Communication Area "CFATK" is set = 0, 
control is transferred to $TYPL in &CHED: 
"OPATtJ" is set = 0. 

3.^1.1 IGCC^J 

This section is responsible for the initiation of stacked I/O operations, 
plocing a prog ran oack in the schedulea state when its I/O operation i- 
con:pietea, ayranac allocation of the two DI^A channels among synchronous 
malfunction^ calling for operator notification of equipment errors or 

<lGCOrj^> is enterec cirectly from <CIC> wben an 10 operation is terminated 
^rrf^rr ^ ^ ^^^ ^^^^^^'^^^ . ^^^^G^<^^^^es have been attempted. On entry to this 
7^. ,^^^^^^. -^^tams Che numcer of woros (cr characters) transferred. 
Ub;-trdCK ir on which error occurred if disc.) 

The addresses of the Equipment Table entry are in ECU to E0T15 in the 
U^Curclxc.lrciLr^o! ''''' '^'" ''' "" pre-processing. The device 

Tcrrr ';f^^'^;^^^^^3/hf P^^^^^^^i^^ £or the completed successful operations, 
to •-rnr ^ .rr "^^^^'^'^^' reouest for the device. if none, lOCM transfers 
rescheduled. '^ ''"^^^ program for the completed operation has already been 

operaMon!^^ ''^ stacked, the suoroutine Dtavi^ is called to initiate the 

Tlrie IUCG^. exit section "IQCX" transfers control to: 

1) <Ccmpletion j,outine> if the system I/C request specified. 

^^ ^''^^rrmni^^^^''^ "^"^"^''^^ '^^^ ^^^^ Stacked On it which must be 

■J) ^lYPl (in sChLt) if the operator attention flag is set (the flaq is 

also clearea oy "lOc.^"). ^ 
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ILLCL Sutrcutine 



by ;.l/c driver ' n P">^«i-^Y if ^r. illegal request is oetected 

icr the dcvir^^; - ^''"f" "'' ^ ^'^^^^ ^"^ '"^ite operation is illegal 

An -.^^^i- ^ " '=^'^t'^°l request is meaningless for the device 

cLpletLr"'V:rd?'TM' '"^ ^^^-^i-^^ to this seo?icn is an "Immediat; 
trol rejt'ct. ' ' '"'"" ''^°"' '^^ ^"^"'- ^^ is processed as a con- 

affol^ows:""^' "messages may be defined by HP system or user drivers 

Tr~^,o J'^'-'^'^V'^t; f^r HP KTE system modules and system drivers 

feul'jg 'e'cr^fn f°' '*''= "P°^^ ^'°"it°^ (see Spo-ol IMA). "• 

iJi' Jj Kestrvea for user orivers. 

iirror procedure is: 

^' llc^ iV"i^^^^'' processed as buffered output, the temporary 
1..1CCK IE releasee to available memory. 

''■ --howevrr* '^.'?'^?'!'' " "" ^^^^*'"' P'^^g'^'^'^ generated the request 
is crer^L'/ "^ ^''^^r'^f, '°"""' ' " specified in the request, 
that thi' c^nci Mrn'.f. t^ philosophy is based on the assumption 
uMcJL cms ccriditicn should never occur.) 

treatec''a = ^'?^^?^'''' 'f ^ °' '' ' "^« '^^ P^ • 22) which is rejected i. 
schecule fist. Performed. The program is linked back into the 

ft unbuffereci user read or write request reiect (A=l) causes n 

aiagnoEtic to be i^cupr< M'rn <i"\ i„, ;- itjecc (a ±) causes u 

J J..- ui^ u(_ i^^ueo ( lu u / ) anc the program aborted. 

Other reject codes (A>5) for unbuffered user read or write requests 

oode and^trnrccra/^nff "-^-ssage where "xx" is the "rrlr'' 
^^^^ aiiu T:ne prc9rd.(Ti will be aborted. 



3. 

4. 

3. 



-^•^ KiscellanGouE Routines 

<$IOCL> Subroutine 



conditio"«^SLini',>nr""'-^' ^^ ""'°^" ^ P^^S"™ f^^'" -" I/O hang-up 
device! "-"Itmg Iron, an input request not being completed by thi 
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processor in "tcitr" c-!l^== Ut^ c '^ commara. ihe "Ot" statement 
suspended fc.r en I/O inpu? revues?? '°" '' "^' referenced program is 

gt^ec'LaL.srcVrres'cnc-Lr'tc'?h^ TK, entry is searoheo to find the 
'ihe entry is rernoveo f rcK th. list ano thrti t1.''" -^-enced program, 
to reflect the change. If the'entry^^^as'the'l r tTTn'lTtcl 1 "^'' 
cIea;'r:cue't'nconri^'rr'- %"" '^" '^'^ '' -'^ dow;;'or L D^r . ait then a 
onl^aftL the driver '-ooir°'rM'"'^'^^'"^""^°^- 1'*^" "" ^e done 

mapped in if needed! If '^?he'reoues't'i''^ccrot''%'H' "''' '""^ "''"'' " 
FXDPrfpr^ ^r,rT 4-K^ - • request is dccepteo then an interruDt is 

"e'slgn b't of yrwcrd'fio^f^"'^^ ■ ^'"."'^^^^^^^ ti.eout of 'f "Second, 
timeout «i 11 be trapped ir <?prv". "^■^*"^^''''^" clearing. The 
recoanizes ,-r^l-i f^t "*-<5'^l^^"> ana routed to <ICCCfc>. <IOCOM> 

then the tiaeout i? r?r't?^ ^^ t \- •" '^''^ request is not accepted, 

the next request. control is given to <I0C0M> for initiating 

<ICDWE> Subroutine 

returns' t^t^rcal^erf ot^erSI^e' 'L°' t" ''' "™'^^- " '' '^ -^-' '^ 
"li.PDT ERBc" anc qoe'- tc fh^^^h ".S^^^s up to print out the diagnostic 
<.no goes to the scheduler module s message processor. 

^•^ Class I/C Kequeats 

inf"mat?on1rf "cl^sl-ly n::Ler "'t?' "" "^^^^ "'^^"^^ ^'^^ completion 
'-the KIICC request^. bufler Lmrrv fA. Iv ""^^'^ requests I/C on a class, 
the buffer ..emory: queues the rLuest en tf^!"' ' • ^"?ves the request to 
the class oueue that a rea^pt^ t2 -, specifieo EQT, and enter in 

request is oueued in the m^^o ' '^^"^""^r ^" completion, the completed 
is restarted ^^' ^"''"^' ^"^ ^"^y Program waiting for the class 



The tabll consists' of 'i^lenqlh'eor"''?'^ """ f'" ^^ ^^"^^^ ^^ $CL«,. 
followed by one wore for each class.' "'' '^^^ number of classes. 
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Clasjj i/( "Cueuc. Ic.i]-u;i;t arc. i i j;; use 



'^ie clc;.£. G ciueuG c^n ce in four different states. 

1j 14 13 12 II. IL u9 tt: u7 OG Od 1,4 03 02 01 00 

1 (H I C I G I I U i C I G I CI I 1 I I I 1 1 



State 1: Cicrs dealloccted , available 

15 1^ 13 12 11 10 9 (;£ 7 06 05 04 3 02 01 00 

I 01 ALERESS (;i' 1- ItST LNTitY 



i::tate 2: Pointer tc first entry in clasE queue 

15 14.13 12 11 10 09 06 07 06 05 04 03 02 01 00 

I II 1 XlSECUKITY CCI,:.E; I KUMBDK CF FEKDIlsiG B..ES | 



State 3: Class allccatec, nc one waiting on class. Wurnner of pending 
requestG counter may oe 0-255 
15 14 13 12 11 10 09 C(; 07 06 05 04 03 02 01 00 

I II 1 1)^1 SECUM'IY COCLi MUr^BET. GF PL.NDII'^G FEQS | 

L'tate 4: .Class allccatec , sonieone waiting (suspended). tvuinber of pending 
requests . ccun ter niay De 0-255. 

/■c tiers to DC taken when liancling a class I/O or get request oeperd on the 
current state cf the class queue iiead. 

State 1. Abort the prcgrair IQOO, no class 

State 2, Feturn the cata from class buffer 

State 3. ^et the seme ore waiting bit (bit 14), suspend prograii^ 

i^tate 4. /'Dcrt the Prograrr lOOO, only one program may be suspended 

■per class. 



t lass I /C h e q u e s t s : 

State 1. f^'tate J is set up, security code is low 5 bits of program ID 
t^umioer, ccunter is set to 1. . 
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Stc'te 2. 'Ihc counter c'lt end ct queue is incremented Dy 1 
State 3. 'ihf. ccurtc-r is inc reinentec by 1 
State 4. 'ihe counter is inc rernentec oy 1 

n Ccmpletion ci Class 1/G r.ecuests: 

State 1. Illegal — siiculd never happen--buf f er is returned and the 

ccnipletion is ignored 
State 2. 'ibe nev/ cata is aodec. at the enc ct the list (FIFO) and 

the counter is decremented' by i 
State 3. 'ihe new data is added at the end of the list (firo) and 

the counter is decremented by 1 
L--'tate 4. 'ine waiting prograiri is scheduled and the counter is 

oecreir.cntec by 1 and the someone waiting cit (Bit 14) is 

clearec. 
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1.' iCui I .. CCl; t . 

V'l here: 

i-^ = 1 i t L'l :■ requi rec 

^ = .1 if au t:cA(c..t ic output Duffer ing used 

t' = 1 if c river is to process power fail 

i3 = 1 if oriver it to process time-out 

"i- ^ 1 if cevice timed out (system Fets to zero Defore each 

I/O request) 
Urji t -■ LBr::t Eub-cnannel sddrecsed 
Channel^ 1/0 select code for the I/O controller (lower number if 

a inulti-DCcrG interface) 
AV - 1/C ccnfrcller availability indicator: 
0= c'vai loOle for uf;e 
1= aisabled (down) 
2= Dusy (currently in operation) 

waiting for an available DMA channel 



'/ -~ 



STATUE' = the actual physical status or simulatec status at the end 
of each operation. For paper tape devices, two status 
conditions are simulated: Bit 5 = 1 means end-of-tape 
on input, or tape supply low on output. 

f^C = type of device. Vihen this octal number is 
Ti^l:f linked with "DVCx," it identifies the device's 
CODL software driver routine 

COKvvD = user control word supplied in the I/O EXEC call 
(see Section III) . 
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1 . Ir.t re rue tier 

lhi£ part of the technical specs .nanuai ceals with the LXEC and syBtem 
available niea:ory pcrticn cl the FTr.>IV Operatinq System. The EXEC is 
that porticn ci the cperating system that checks for legality of all 
user E>F:C requests, vectors legal requests tc appropriate processors, 
vectors Illegal requests to the abort processors, handles reentrant 
processing, anc' allows users to execute with the interrupt system off 
(privilegcQ subroutines). 

The $ALC portion of the system allocates System Available Memory (SA^.) 
to system processors that request memory for buffer, tables, etc. 

Tiie rxrc modules contains five major sections: 

1. Eyrtem Bequest Analyzer (Memory Protect Violation Control) 

2. Kesioent Library Execution Control (Dynamic tapping Violation Control) 

3. Privileged and Keentrant Subroutine Frocessors 

4. Disc a rack Allocaticn and Release Processors 

5. General Error ^''essage and Program Abort Processors 

In order to understand hew the system receives and handles an EXEC request, 
It is necessary tc understand system memory protect and the rudiments of 
interrupt processing. The discussion below is a very brief description of 
interrupt processing with memory protect. 

Suppose the user wishes to do output to the line printer from a high level 

language like FOPTKAti. He may code something like: 

CALL EXEC (2,C ,IBUtR,IBUFL) 

where the 2 is a Krite Request, the 6 is the LU,IBUFR is the buffer to 
write, end IRUFL is the buffer length. 

The FORTRAIx ccmpiler would change this to something like: 

JSL EXEC 

DEF REli-t' ' Return address 

FRF IV PIT Address of Request Code 

CLE LU I to write to 

DEF IBUFR buffer Address ' ■. 

DFF IBUEL ]:.uffer Length 

RE'J'RIM- 



J;i 1.XLC will gcrcratt^ e. Utcu^cry 
IPZ, S-iA, STL, LST, CEl , JLY, JPY, 



hhen thi£ ccce is cj; ecu tec' the 
protect. In feet ai'y Ji y , j£'£ 

'VI:, t:V\ , EAX, s;.Y, StA, SlY, :.iy, or sty instruction which would 
either cirectly or jrciirectly offect a nierncry location Delcw the MP 
i-ence v;ill oe inhicitGC and friemory protect will force an interrupt 
tc Location 5. The lower bound of protectee nieiriory is Location 2 
the upper bound is set byi the op system with an GTA 5 (or CTE 5) 
where A is the address of the highest protected word. 



ihus the J.^.b L>;I,C was never executed, rather the contents of trap 

cell 5 (the interrupting Iccaticn) was executed. The 

cf trap cell 5 is a JZL $CIC,I. ihis now allows us 
cp systGiii into a aicdule cbllec RTIOC. 



contents 
to enter the 



i/ilOC IS obliged to find cut where the interrupt came from and what 
kind cf interrupt it was. Ly executing a LIA 4 RTIOC will receive 
the interrupt code # of. Ic^st interrupt. If the interrupt code 
corresponds tc the Time Base Generator RTICC jumps to $CLCF in the 
FTIf'iE module. If the interrupt code is 5 (Dynamic i\:. apuing , Meinory 
Frctcct or Parity) KTIOC jui^^^s to LXEC. If the interrupt cede is 
anything else FTICC uses the interrupt table to look up the appro- 
priate processor. 

If the interrupt was on interrupt code 5, then a IIA 5 (or LIB 5) will 
give the viclaticn address; i.e., the address cf the JSE Ei^EC. 

Pigure 1 shews a graphic representation cf a J SB EXEC. 

We now knew low the systerr' enters the EXEC. 



Fiujiai' 1 



JSB EXEC 



■>^- 



•MEMORY PROTECT 
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RTIOC MODULE 

$CIC NOP 
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» 

JMP $RQST 



EXEC MODULE 



$RQST LIB 5 
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sr 



JSB $CIC.I 



. 



The user tries tc execute a JSB EXEC, ir.emory protect catches this ana 
instead executes the contents of trap cell 5. This causes an entry 
into the imcdule FTICC. RIICC turns off the interrupt system analyzes 
where the request is to go and turns control over to the appropriate 

procesEcr. 



(1) LKtC Call PrcceLEcr 

'ihe primary function cl this section is to provide for general checking 
£.nr exarrinatlcn cf EXEC CALL requests (E}:ec requests) and to call the 
a p pr o p r i a t e p r o ce s s i nn routine. 

XhiE section If called cirectly from the Central Interrupt Control (CIC) 
section (in isTICC) when a mciTiory protect (hP) or dynamic mapping 
violation (DM) is recognizee. (All system requests from a user prograiTi 
cause a protect violation.) This section also determines non-legitimate 
protect violations in user programs such as executing halt or I/O 
instructions or etteropting to write into a non mapped or protected area, 
it also recognizes user calls for resident library routines, re- 
entrant, or privileged processing. 

Upon entry from CIC EXLC i^ust decide vvhether the violation was a true 
men.ory protect, parity error, or iTapping violation. The E>;EC request 
analyzer examines all memory protect and Eynaniic tiapping viclations. If 
the violation is legal, the L'XE-C jumps to the appropriate processor. 

A Lh: viclaticn is distinguishea from a kP violation by executing a SFS 05 
instruction. h Ef, error wi]l set the flag on channel 05, a MP error will 
clear the flag. 

Since parity error and memory protect share the same interrupt locations, 
it is necessary to distinguish which type of error is responsiole for the 
interrupt. A parity error is indicated if, after the LIA (or LIB) 05 
instruction is executed, Dit 15 of the selectee register is a logic 1; 
a memory protect violation is inoicated if bit 15 is a logic 0. In either 
case, the remaining 15 cits of the selected register contains the address 
of the error location, ^ote, however, that parity errors are detected 
in RTIOC not LXEC. 

Only one form of Ll^iS violation is legal. This DhS violation will occur 
when a memory resident program tries to enter the miemory resident library. 
The memory resioent library is used only by memory resident programs. The 
physical address of the library will be above the memory protect fence 
if the program is using common; however, the pages containing the library 
ere write protected. lhu£: any JSB , JWF , etc. to the library will cause a 
DFiS violation. EXEC, after determining that the violation is a DMS 
violation, will check for three conditions. They are: 

1) That the call is a JSL 

2) That the destination is in the memory resident library 

3) That the program is a memory resident program-Type 1 



Tr.G iDL Clenpcrary rata i.lcck) ano return tic jus indent is only fox re- 
entrant forruat. iLe return ddDuslment lor re-ei:t rant lormat in th© exit 
call IS usee tc vary the return point to the calling program. The" 
return address ana return adjustment are accled tc determine the final 
return aocress. 

The parameter following the JSE $LI.EI: (DEF TDB , or WOP) identifies 
the subroutine format to the system and the type of processing that is 
requirec. A LCP signifies a priviledged subroutine. 

he-entrant programs may call other re-entrant and privileged programs. 

however, privileged programs may only call privileged programs. 

Ihe JS.b C^tlEB is intercepted by EXEC because it causes a memcrv 
protect. ^ 

PhlVIIEGED &. hLEN^.I.AiSi'l PRCCESSItK; 

iriveleged or reentrant processing starts whenever the initial ruemory 

protect or ^^:A vilation for that service is detected. This can happen 

m two ways. trt- 

Consider the two cases below: 

CA££ 1 /^t,Y FRCGFA^C ■ ' 



;UB 



all in the same program 



JSb $LIEE 



CAST 2 ta^OR\ IU.f'!lCn:i l;FCGKA^. 



J Si: sue 



MEt^iOEY re;sident library 



& U ti I'' G £ 

J£B $L.IDi:. 
IvCF 



In Case 1 all cede is vvithir the users program. The JSB $LIBR causes the 
merncry protect. As mentioneci earlier ^LIBR is a valid rcercory protect and thus 
the system starts the privilegoc or reentrant run. 

In Case 2, ho\vever, a Hi violation resulted due to the JSB SUB. This is 
oGcause £UE resiaes in the meiTiory resident library. Here the privileged or 
reentrant run starteo at the JSB SUB. EXBC places the return address 
(FHl of JSB 3UB) into SUB that is, it simulates the JSB instruction and 
eventually returns control to three words past the SUB NOP (i.e., the target 
of the JSP). In thir; case the JSE $LIBR was never executed. 



can 



be seen from Case 2 all subroutines that are loaded into the memory 
nt library (type € subroutines) must be in the privileged or reentra: 



resiaent library (type t subroutines) must be m the privileged or reentrant 
format . 

CXEC examines the were (p+1) following the JSB $LIBR. If (P+1)=0 (NOP), 
the called eubroutine is "privileged". $LIER restores the registers, adds 
1 to "?rvCN" (privileged subroutine nest count) , leaves the interrupt system 
disabled, (which also moans FjV disabled) and transfers control to the word 
following the $LIBF call (i.e., F+2) . The return address to the .program 
(P+1) of the JSE SUB is stored in the entry point of the library subroutine 
if a protect viclaticn occurred on the original call. 

If the (P-H) of the JSB $tIBP is non-zero, the value is the address of the 
Temporary Bata Block cf the re-entrant subroutine. The 1st word of the 
TDB is checked. If it is zero, then the subroutine is not being reentered. 



.....G 1st were as. then ret up tc pcirt tD the 2n6 word of a 4 word baonk rt 
niemory f:,ct up fcr ecch J^E aJEP usea in a reentrant run. Thi?^ t>lock 1ft 
iGcatec in vy^tew. available memory (SAM). The contents of this secona 
word IS the ID adoresE of the program ufiing the TDB. (More aiscussion on 
this reentrant list structure will be found in the following sections. 
ixelercncina to the list structure in Appendix A at this time should help 
IP understanding the discussicn below.) 

If the link word is ncn-zerc, the subroutine is bieng r. -entered (i.e., two 
niemory resicent prcgrair^s want the same subroutine) and $/\LC is called by the 
LaLC I'-'iLB routine to allccate a block in available memory eoual to the lengt 
ot the ^Lii (word z), it $alc rejects the allocation request, the main user 

program is suspended anci llnkeci into the memory suspend list. 

If theblccK is allccated, the TDB is moved to the new block. If the new 
biocK IS one wore longer than requested (refer to discussion on $ALC) , word 
^ (word length of 'IDE) in the new block is set negative as a flag. The 1st 
wo r CI of the moved TDE in the system map is chnged to point to the 1st word 

of the original aiB in the user map. 

Ihe acidresE of the original program call is set in word 3 of the program TDB 
as the return address. The re-entrant program must not m.odify the first thr( 
woros of the TDB. EXI C then calls $RENT in the dispatcher who sets the 
ine'T.cry protect fence to the beginning of the Resident Library area, removes 
LKt write protect, ano restores the program registers. The interrupt system 
IS enabled, memory protect turned en, and control transferred to the program, 

Fcr privileged subcrutines the system saves all registers going into the 
sucrcutine anc restores them when the subroutine starts to execute. V^ith 
nesteo privileged subroutines the system does not save the registers on the 
^,J,4, etc., call but neither coes the system destroy the registers. That 
is, the •". ,S,Y,X,E and G registers may be used to pass parameters to 
ano from privileged subroutines (enci reentrant subroutines). 

The return tc the main program at the end of a reentrant or privileged 
subroutine is performed by a JSE aiBX. The execution of this instruction 
IS executed airectly if a privileged program is executing; it causes a memory 
r^.r,.^, ^^^r '^'"^^' ^^ ? re-entrant program is executing. In the latter case, 
LaLL transfers control to <.LIBX indirectly after the initial protect violatic 
processing. ^ ^jj.a^x^ 

If the executing program is privileged — i.e., ($PVCN>0) one is 
subtrancteafrom $PVCI.. If $FVCN is still non-zero, control is returned 
directly, with registers restored, to the return point in the callinq 
privilegea program. If now $PVCN=0, control is returned to the caller 
with the interrupt system enabled and the memory protect fence set to the 
beginning of the area of the original calling program. 



If the ejcccutincj prcv^rc-is, ucf reentrant tht return address is celculatecj by 
adding the ccrter.ts cl. the ire wore ot the "]DL- which contains the t-^X ©f tht 
criginal OSB TLL and the 1+2 of the JSB pLlEX which may contain a return 
cdjuBtnient. 'Ihis address is placed into the ID segments point of suspensiori^ 
ir addition, the necessary adjustments are made to the reentrant list and 
to systeni available menory. This structure is discussed below. 

All $LIJ:i- callr require ar; asscciateo $HBX call. 

Eeentrant List Structure 

Every reentrant call requires the creation of a 4-wcrd table in system 
available mei-nory callec a reentrant table. All of these tables are 
connected through a list structure with its head in the EXEC (DHED) (the 
reentrant list). The list is a two dimensional list. The 1st dimension is 
a stack and is one entry per prograiT,. The 2nd dimension is for programs that 
make nested reentrant calif- and is a push down stack after the 1st entry 
(i.e., the one that got the program in the list in the first place. 

The purpose, structure, and content of this Reentrant ID list is 

graphically dccuinented in Appendix P. 



/ trcck, if eilccatet tc a ccoqrnr, ii: fn.ch that oray tliat t:.'-C^^^«"^ii^' 
v.hich requrstGci it car. write en it arfVer. rclea^f: it. Any prcqrort^ 
Cc.n reac frcin it. -* t ^ 

J^:. glebe;], treck is -uch that any program can read from it, write on it, 
anci/er release it. 

Track contrcl is maintairec via the Track Assignit^ent Table (TAT). 
Peripheral discs (NOT W 2 or LU 3) are not manaqed thrcugh the track 
assignment table. " 



Figure 3 shows the structure of the system disc (LU 2). The system disc 
has three cistmct areas. The first area, from Track tc approximately 
track ^f^' f*-^-^'- -* — . ,• 1 T .. ■: . -.. .. . . *-*^ J 

to 

cop 

generation time are stored in this location. 



o Li'iee cisEinct areas, me first area, from Track tc approximat( 
ack 20 (this area will vary depending on the size of the syetem, 15 

40 tracks is typical) is the system area of the disc. The virgin 
py of the operating system, drivers and all user programs loaded at 



The second area from approximate track 2C tc say track 100 is the track 
pool or scratch area of the disc. The upper boundary of this 
area is determined the first time a generated system is booted up. 
Ihe bouncary is set by the File Manager initialize command. (IN, 
J'aster sec code, -LU, cartridge ref . , label, start track, # of tracks). 

The Track Pool is used by the system for swapping, text editing, loading 

permanent program additions, etc. Ihere must be a minimum of 8 track 

pool tracks or lU 2, however, a minimum of 70 track pool tracks is 

reccmmendec. 

If the Extended memory Feature cf RTE IV is being used more track pool area 
may be necessary to allow swapping of large arrays. The additional space 
neecec can oe gauged by recalling that one disc track contains space for 
6144 words. '^ 

The third area cf the system disc is for user files. The File 

Manager maintains this area. 

An auxiliary disc (LU 3), Figure 4, can be used with RTE to extend 
the size of the track pcol if desired. 
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liack r^SEigr-Poent 'iable (I^T) 

Ihe 'Ihl is a vcirieble length table describing the availability of each 
ci£c track en the Eystein arc auxiliary discs. The TAT is constructed 
by "1M4C:/' basec en user parameters declaring the size of the system 
cisc am;; the availability and size of an auxiliary disc. Each track is 
representee by a cre-v.ord entry. The first words of the table correspond 
to the "n" tracks of the system disc. The word "TATSD" in the Base Page 
Communication .^rea contains the size of the system disc as r positive 
integer. if an auxiliary disc is included, the rest of the TAT contains 
one-v/ord entries to describe the tracks on that disc. 

"RT4GN" initializes the protected tracks of the system disc to be 
assignee tc the systeu; (periPanently unavailable). 

Ihe contents of a track assignment entry word may be one of the five 
values: 

Contents of Track Assignment Table 

Contents r:.eaning 

C 2-\vai Iable 

100000 Assignee to System (or protectee) 

077777 Assigned globally (anybody can write) 

077776 Assignee to F^^GP (FKF Package) 

XXXXXX ID segment address of owner 

Base Page ivcrds Used for Track Assignment 

BP Vvord Name Purpose 

1<^'56 lAT FWA of Track Assignment Table 

I'^SS TATLG NEGATIVE length of Track Assignment Table 

1756 TATSD # of 'Iracks of System Disc 

1*^57 SECT2 # of Sectors/Track on System Disc (LU 2) 

l'^6C SECT3 # of Sectors/Track on Aux Disc (LU 3) 



Graph icclly the 'lAT if. searcheo as £hown be lev;: 
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From the Giagram above, the user can see how to optimize system search 
tiifiG for iiree tracks. No FMP area (or a very small area) on LU 3, 8 
tracks oi track peel on LU 2 (rainimum required) will optimize system 
search time for system tracks. The user can also improve system 
perfcriiiance physically by putting LU 2 and LU 3 on separate physical, 
discs. 



LU 2 one LU 3 are Dcth limited to a maximum of 256 tracks. 



li-;e L.Xi:C vvill detect five classes of errors Fjemory Protect (MP), 
Dynan.ic Lapping (IM) , Request Code (RQ) , Reentrant Subroutine errors 
(kE), ana iarity LFRCRii (FL) . 



All ot these errors will Cciuse program abort ion (even if the no abort bit is 
set). The error luessage and the error is aiscussed below: 



MEMORY PROIFCT 



IN ^]f 'i [HF OPFK^IlNr, SYSTEM IS PKniECTtO RY A HAKOwARE 
MF^^OHY PHOiecT. THIS MFa^S T H A T An Y PKOGR AM THAT ILLFGALLY 
TRIES ro MODIFY UR JUMP TO THE OPFNATT(v<G SYSTEM »ftiILL CAUSE ^ 
A MEMORY PR(ilECT TNIFRUPK. THfc OPERATING SYSTEM TNTERCEPTS 
Th<E INfERUPT AND DETERMINES IT'S LEGALITY, IF THE MEMORY 
PROTECT IS ILLEGAL, THEM THE PROGRAM IS ARORTEU AND THE FOLLOWING 
MESSAGE IS REPORIED TO THE SYSTEM CONSOLE : 

MP INSI = XXXXXX XXXXX = OFFENDING OCTAL INSTRUCTION CODE 

ABE PPPPPP QQQQQQ R CONTENTS OF A , B & E REGISTER^? AT ABORT 

XYO PPPPPP OuQuQU R CONTENST OF X,Y K REGISTERS AT ABORT 

MP YYYYY 77717 YYYYY = PROGRAM NAME, 17ZZI = VIOLATION ADDRESS 

YYYYY ABORT Eu 



DYNAMIC MAPPING VIOLATION 



A DYNAMIC MAPPING VIOLATION OCCURS 'WHEN AN ILLEGAL READ OR 
vvRITE OCCURS To A PROTECTED PAGE OF MEMORY. THIS MAY HAPPEN 
WHEN (JNE USER TRIES TO i^jRITE BEYOND HIS OWN ADDRESS SPACE TO 
NON EXISfANT MEMORY OR SOMEONE ELSES MEMORY, IN THIS CASE THE 
PROGRAM IS ABORTED AND THE FOLLOWING MESSAGE IS PRINTED? 



DM VIOL = WWi^wtAi WifvWwW = CONTENTS OF DMS VIOLATION REGISTER 

DM INST = XXXXXX 

ABE PPPPPP ijQQQuQ R 

XYO PPPPPP uQQOOO R 

DM YYYYY 77. ^ZZ 

YYYYY ABORTED 



EX ERRORS 

IT IS POSSIBLE TO EXECUTE IN THE PRIVLEDGED MODE (IE INTERUPT 
SYSTEM OFF) IN THIS CASE THE USER MAY NOT MAKE EXEC REQUESTS 
BECAUSE MEMORY PROTECT, WHICH IS THE ACCESS VEHICLE TO EXEC IS OFF. 
AN ATTEMPT TO MAKE AN EXEC CALL VMITH THE INTERUPT SYSTEM OFF 
HILL CAUSE THE CALLING PROGRAM TO BE ABORTED AND THE FOLLOWING 
MFSSAGt PRINTED : 

'^'X YYYYV 71717 
X ABORTED 

This error is detected in $TB1 . The error is detected by virtue of the fact that 
EXEC was entered directly instead of causing a Memory Protect.. 



UivFXPfcC FFt) UM And Vip tPwOKS 

THt UP(-fVAllN6 SYblhM HANOLE.S ALL MR aMD l)-^ VIOLAJIUNS 
CFHTAIN OF THFSF VlflLMTUNS ARt LFGAL A'yJD UThFkS ARF NOT 
IN Af.Y CASt Ht UPK^ATING SYbTfeM ASSUCIAIPb rHtSt VIOLATIONS 

.TaCM^Wf'^ r-'S'^!^- ^^ ' •^^' ^^^ ^^ t^^'^^' UCCUNS AND NU PROGRAM 
»rAS ACIIvF rHF.Ni, THIS IS Aim UNFXPECTtO MR UR DM VlLATlUN 

iriHrs'Vnp'TM^ If ^"'^'^^-^^' ^^ENF IS NO PROGRAM TO ABORT* 
IN THUS CASF THF FULLOWlfvjr; MFSSAGE i^ILL BF PRINTED : 



DNS VIUL = wy^^WAj 

Om INST = XXYXK OR N^p irvSl = XXXXX 

ABF PPPPPP UQQQyQ K ABE PPPPPP QUQQQQ R 

XYO PPPPPP QQg.JQQ R j^yjj PPPPPP OQOOQy R 

l>i <I'VT> ^p <I^,^> - y 



WARNING ^AR^MlNf; I'JARnING t^ARNlNG WARNING .EARNING 



THF AbOVt MtSSAGF ^^HlCH SPECIFIfcS <INT> AS I HE PROGRAM 

nPHviLir^^^''^ ^° ^"^ "^^^ ^""^^ ^^ UNEXPECTED MEMORY PROTECT 
OR DYNAMIC ^1APP1NG VIOLATION ERROR HAS OCCUREO. THIS IS A 

H^.i°'.\TJc'''''' ''' "^ ^'"^'^'^ INTEGRITY. MOsi T MES U MEANS 
THE OPFR 'G^SYSTFrr^?^''^ PRIVLEDGED SUBROUTINE) HAS DAMAGED 
PTw^u^ I3^r V^^^^ INTFbRtTY OR INADAOUATELY PERFORMED REQUIRED 

HAS F^T Pr f'.V.L'''''''''^''- '' ^'' ^^^0 MEAN THAT THE CPU 
HAS FAILED AND IHAT THE OPERATING SYSTEM CAUGHT THF FAILURE 
IN TIME TO AVOID A SYSTEM CRASH. ^ u»,n i mrr I-AILUHE 



ttTnt^"°' '^^ ^^"^'^'^ Available Me,«ory for the Keentrant ID List and 



Moved TDB 's 



The reentrant processing of reentrant suDrcutines anci automatic 

o ":^or^ '%'^::^f:f J/^,-^--,-^--^ the te^por^rfu^e^of blocks 



If a block size requcstea is not available, J?/\LC returns a reject 
maication to the caller.l ^Kih checks the list of programs suspended 
waiting for memory each time a Dlcck is released. ^RTM calls $LIST 
to £ch£cule all waiting programs (list type #4). 

Calling Sequences; 



1) 



$ALC 

(P) 
(P + 1) 

(F + 2) 



(Allocate section) 

(if words needec) 
-Return- 



On return; 

(A) = FKA of allocated block, or = if reject 

(B) = # words allocated (may be 1 greater than # requested) 

If no block is large enough to allocate the requested length, (A) =0 

(Keturn blccjk section) 
J SB $KTN 

(FV^^A Of buffer) 

(# words retjurned) 
-Return: Registers meaningless- 
There are no error conditions cetected by these sections. 

Due to the way $ALC is linked, it can happen that the user will ask 
^ALC for b. woras and instead get lai. This happens when a request for 
t>J worcs would only leave 1 word of system available memory left over. 
Since $ALC requires 2 words for its link structure anci only one word 
would be left, $ALC gives: the other word to the user to force him to 
keep track ct it. Appendix A also shows how this one extra word is 
carriec along if the neec arises. 



on 


return 


2) 


$RTN 




(F) 




(P + 1) 




(P+2) 




(P + 3) 



1 Iccateo ir 

ncGc ret 



chui.k^:; hcucvei, v^vIC is Vxtitten 



i.ci.icry It eilccateo ir ccntic, l:clu; chui.k^:; hcwcvei , ^hiC is Vxtitten 
EC thaL iiL ncGc rctL., ccnt^JUcu£ u.^iuory. Ihe ciEccnnccted blockl 
ci :ner:,cry are linkec tl rcucji; the first two woros of each block. P- drawi 
ol the linkage for R'iL-II is shovri below eg the reader will understand 
hcvv the routine will v.ork ir the oeneral case. 



nt, 



$ALC+174B 

$alc+173:b 

$ALC+172B 
$ALC 



1 Pointer 


to 


£A^: 1 


iMeiTiory P 


^vail .Kowl 


jEEF *41 1 



SAl. E TvCFDS 



77777 



SM'} Q WORDS 



::a^: p vceds 



High Memory 



■eqiTient 3 



Segrr.ent 2 



Segment 1 



The ~1 in the DUMMY $ALC list 
means no iDGiLOry in the first 
block ie the dummy block. 



. _-,-_, Lq^ Memory 

First word of each blcok=# of words fin the block (P,Q,R) 
Second wora of each block=Pointer to 1st word of next 

block or 77 777 if no more 
blocks. 
B^IGURE A 



i;cw suppose the uter rcti^tni: C-f 
SAi now locks like: 



(vC vc\i-.) 



Start cf 3rc; 
block which 



used to 
block 



be 2ric 



End of new 

2nd Block 



End of let 
block has 

changed-S tart 
of new 2nd Block 



A 



$ALC+174B 



1 Pointer to SAM | - 

——-.—— — -.— __- 1 


1 Ijeii) Avail 


1 

Now : 1 1 


1 DEF *+l 1 



100 V^ords Allocated 
by 1st Call 



10 Words Allocated 
by 2nd Call 



8 



100 Words Allocated 
by 4th Call 



6 00 



Pointer to next 
block 



< — 



Pointer to 
Next Block 



Pointer to 
next Block 



Also; 

Feturned ineniory is always concatenated if that memory is found to be 
contiguous to a free block above or below the returned memory. This 
insures, continual maximum block size and eliminates need for garbage 



Asking i^ALC for mere contiquous merrory than is currently available 
(fEEUiriny that that iriuch v/ill ever be available), will force the 
requesting prcgrai:! into the unavailable memory suspend state (state 
4) . ^.'^LC perfcrms the necessary $LI£T cell and places the # of 
words requested (Dut unsatisfied) into word 2 of the reauesting 
Luograrii's IF segment. Thereafter, every time memory is returned to 
the syr:teai $.FTN checks to see if the suspended program Ccin be given. 
encugh jiiGiPcry arc rescheduled* Until that program can be rescheduled 
ixC mere Teniory is given away to programs of lower priority. $PTlsl 
checks only the 1st program in the unavailable memory suspend list. 
This insures that the highest priority program gets the memory first. 
(Kecall that the unavailable memory suspend list is ordered by 
prog ran' priority.) 



AFPLt^DIX A 



AFFE.NDIX A 

Re-entrant List Structures 



The first word,' TDB, will be used by the system as follows: 

- subroutine is available 
=0 - points at 4 word block describing current "owner"; 

i.e. the program currently executing in the subroutine. 

tf^hen the TD.B is moved to system memory, the 1st ?ord is changed to 
point to the location the TDB must be moved back »-.o . 

Ihe sign bit of the 3rd word of the block indicates if the block 
was moved or not. The sign bit of the ID- address indicates if the 
4 word block is 4 words (0) or 5 words (1) long. (This is caused 
by a one word inprecision in memory allocation.) 

The ID Extension List is a two dimensional one way linked list. The 
HEAD of the list points to all programs processing reentrant sub- 
routines. They are added to the head of the list as each J£B $LIEK 
is processed. The ether dimension is a list of all reentrant sub- 
routines being processed by one program; that is, on reentrant 
subroutine calling another. 




^ PROGl 



^PR062. 



>.PR063px 



Y 



^ PR0G4 



PR063 



i 



PROGS 



I 



PR0G3 



(4) 



(3) 



(2) 



I 

Subscripts of PR0G3 refer to order in which the FR0G3 reentrant 
subroutines were called. PR0G4 was the first to enter a reentrant 
routine; PROGl was the last. 



APPENDIX /: 



Figure 1 



One 4-v^crd block is crecited each time a reentrant routine is 
entered. Program l\ and B are bcth in reentrant subroutines. 
i\ entered it£ routine firct. 
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figure 2 



"E" is Euspendec — program "C" reenters "E's" subroutine 

NOTE: The moved status is indicated by "b'S" TBD pointer 
not pointing in turn t E's ID segment ;='ddres£. 
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Figure 3 



Program "C" existL the routine 
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in sub- 
routine 
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in system 
memory 



Total TDB Size 



The routine is available - Bs memory will be moved back when the dispatcher 
is committed to run it. 
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Figure 4 



Suppose in Figure 2, program "E" was to be executed prior to "C's" 
exit from the reentrant routine. Then "C's" core must be saved 

and "B'e" jtiovco back in. 
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Figure 5 



^iuppcsG £tc4rtinc at Figure 2, routine "C" no\s calls ^.nother re- 
entrant EubroLitine -- the list structure is now: 
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TDB PT 
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USER 
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Total 
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AFPEHDIX 13 

The externals . ZFKV arc .ZKii'j are treated as "special" entry 
points in the RTE Disc-r^sec Cneratin.j Systemc, in i"<TE-II, 
ETL~III and KTE-IV. 'Ihe K'lL Generator mocifies the code that 
is leaded for subroutines that reference these externals, the 
changes made cepenc on whether or not the cede is loaded into 
the core resident library (and hencce may be shareable) or if the 
code is loaded with the prcgrair; (not shareable), in the latter case 
the externals are satisfied oy replacing the calls to .ZFRV or 
.ZEKl v;ith an RSS (i.e., .ZPRV,RP , 2001) . These Rp's are passed 
to the on-line loader in the same manner as an operators RF command 
at RTGLN time, thus, the on-line loader can perform the same 
functions as the RTL;-Cenerator with respect to the externals 
.ZFRV, .ZRi-^T, :^^IlbR, ana $L1RX. The following examples should 
help to illustrate how an asseniolec subroutine is modified. 

***NOTE - The capability of handling calls to REIO must also be 
added for compatibility reasons since the new library 
references this routine. 

The coce of .RuTF and .ENTR is included. 



CGKE RESIDENT 
LIERAR!/ 



IM CCPE: RESIDE^']; 



svi: 



LIBX 



f'i t: 



DEE 


.ZF 
LIi: 


DV 


• • • 

DEF 


SUD 

sue 


,1 



F D I V I L E G E D 



K c D a: 1 iv i: 



su 






$LIDD 



LIBX JSE $LIBX 
DEE^ SUB 



SUE.. NCF 



LEE LIB}< 



IBX JMP SUb,l 
FEE SUB 



F' E I V I I E G E C 



E E 1 !■; 



FAEE-1 I;JOP 
PARK 2 EOF 



SUE 



II BX 



SUE 



LI EX 



J SB .ZFRV 
DEF LIBX 
J Eli .ENTP 
DEF PAFE;1 



JM' SUB, I 
DEF SUE 



Fi C R t^ A L 



EiC I' 

J SB .ZRET 

DEF LIBX 



E C) L o U iw 
ISZ TEE+2 
EOF 

• • • 

JEF SU,L,I 
DEF a.DE 
DEC 



PA RE I 


NCF 




FAR^.:2 


NOP 




SUB 


EOF 






JSB 


$LIBR 




KOP 






J SB 


.EN IP 




D£;F 

• • • 


frae:i 


LIBX 


• • * 

JSB 


$LIBX 




DEF 


SUB 


' E - : 


E I, I 


:. V. h N 1 


SUB 


ECF 






JSB 


$LiDR 




D EF' 

• • • 


IDE 




• • • 

ISZ 


SUB 




ISZ 


TDB + 2 




NOP 




LIEX 


• • • 
JSB 


$LIEX 




DEF 


IDB 




DEC 






PAREIl 


MOP 




FARK2 


NOP 




SUB 


NOP 
RSS 






DEF 


LIB^: 




JSB 


.EN IF 



DE:F v\^,pv\ 



LIBX JhP SUB, I 
DEF SUB 

R U I 1 N E 



SUE EOF 

T' C:' C; 

.!.'■ i-i ».' 

DBF LIEX 



ISZ SUE 
ISZ TEE+2 
LJOF 

« • • 

LIBX J IIP SUE, I 
CIF TEE 
DIG C 



F, £ - 



\v 1 1' L 



E b: 



Bi'fLl MOP 
FIsA^.2 ^OP 
SUL- i'.,CP 

DIP LILX 

JLL .Lh'it 

DLF PPTM'^a 

STA 'lLB+2 



PBi^i^a NOP 

pPAr>;2 riop 

£UB K;OP 

Jb li -jiLIBP 

DEF TDE 

J SB .£MP 

DEF PPAta 

ST;^ TDB4 2 



PP. AMI NOP 

PR AM 2 NOP 

SUE NOP 
KSS 

DEF LIBX 
OSB .EN IP 
DEF PRA^Jl 
STA TDE +2 



El EX JM- aDE42,I 
DEF TDE 
DEC 



EIEX 



JSE $LIBX 
DEF TDB 
DtC 



LIBX JMP TDB+2,1 
DEF TDE 
LLC 
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INTRODUCTION 



The scheduler is the RTE IV nodule which oversees prograw state 
tronsi t i t ions, responds to operator input conwands.. begins system 
start up at boot up, and satisfies or vectors to ot^r processes 
eleven EKEC call requests <EXEC 6 , 7 , 8 , 9 , I , 11 , I 2 .. 14 , 2 ■' , 2 3 a^id 24) 
^\\ of this processing is done copipietelM fron within .;.e SMstew 
Map. 



Calls to the scheduler nay cone frow either the user or other parts 
of the system itself and thus fron either the user nop or systen nap 
For this reason a preawble to certain sections of the scheduler are 
found in Table Area l which is in both naps. The entry points that 
start in the preawble ore $LIST, $MESS. fIDHO, and $SCD3. In essence the 
purpose of this preawble is to get the current OMS status for return 
purposes., enable the systew wop, and juwp to the oppropriote processor 
i«Jhile this code is not specificolly part of the scheduler, it isv so 
tospeaU.. thefrontdoor. 

The technical discussion on the schedu I er wh i ch follows assumes that 
the reader is completely foniUar with the 33 word RTE-IV ID segnent and 
3 word ID extension. For those who arenot, Appendix (\ at the end 
of this wanuQl contains a cowplete description of every word/ bit 
a n d f i e 1 d . 



LIST PROCESSOR 



The list processor is q subroutine in the scheduler that is called 
to wove Q progrfiw frow one st-ite to another. In RTE IV a progran 
iS qIwgus sGicJ to fae in q state. The states are! 



STATE NUMBER I STATE 



DORMANT 

SCHEDULED 

I/O SUSPEND 

GENERAL WAIT SUSPEND 

HEHORY SUSPEND 

DISC SUSPEND 

OPERATOR SUSPEND 



The state nunber is the nuwfaer used in the status field (word 16) of 
the ID segment to indicate that o prograw is in a particular state. 
For each of these states/ except the dormant state/ a linearly linked 
list of all programs in that state is kept. The schduler nonages 5 
of these lists. The lists and their heods areJ 



LOCATION 



1 ? 11 
17 13 
I ? I 4 
I 7 15 
I 7 16 



{ 



HA.JOR STATE 



1 SCHEDULED LIST 

3 GENERAL WAIT LIST 

4 MEMORY SUSPEND LIST 

5 DISC TRACK WAIT SUSPEND 

6 OPERATOR SUSPEND 



The I/O suspend state has a list headed 
nanaged by RTIOC not the scheduler. 



at each EQT but these lists are 



Pr ogran s 
changes 



are waved in and out of these lists as their wajor state 
sts are Maintained in priority order with the 



changes. The lists are Maintained in priority order with the 
highest priority prograMS first. Programs of the sane priority are 
added to the list beh>nd the others of sa«e priority. Each list 
!3 threaded through ID segnent word I and is terminated vHth a zero 



-3 



Ana nunber of things c.n cause a progr<.n to «ove fro« stote to 
»tote. For e>iaBple, suppose FWGR uas executin 




rhere is no user interface to the list processor. AH colls to 
the l.st processor cone fro« other s«ste« «odules. User requests 
n:t';r:ce:::"""' '" ''- "" °^ scHed«.er .„d then ,<, IIT.V' 



CrtlLIHG SEQUENCE 



ON 



.J SB 
OCT 
DEF 
RETURN 
If A 
If rt 



$L 1ST 

(Address C ode >< Func t i on Code) 

(Address) <This word not always r 



equ i red) 



- 0/ then no Message ?« 
not = / the A = flSCI I 
B contains deciwal error 



6 = PROG IDttdd r ess 
error code address 
code 



Address codes of 0. &. 8. 7 ore reserved for drivers 
The only function code allowed with these oddress 
codes is I < schedul e ) 
IfsuccessfulA=OELS£ 

B = 3 ILLEGAL STATUS 

B = 5 HO SUCH PROG 



a prog nane to an 



For driver that wonts to convert 
ID address: J SB *LIST 

OCT 217 

DEF PHAME (Prog Nane) 

This performs a sinple list nove like changes to priority 

.A'-'o7rMi ^''ru^\n*'' " ^'^ '^^^'- "P^" ^ successful 

s i.hiduip. l^' ^^ address of the program. If the progro« 
»s scheduled nony tines doing this "sr uh 



< If 
return 



the ID seg of the progran 



rewoves the search tine for 



FunctionCode 

=» Dormant Request 
= Schedule Request 
= I/O Suspend Request 
= General Wait list Request 

- Menory Available Request 
= Disc Allocation Request 
= Operator Suspend Request 

- Re I inr< Progran Request 
thru lb are not assigned 



I 
2 
3 
4 
5 
6 

[? 

10 
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Address Code 

= ID segment address 

1 = ID segment address 

2 = ASCII program name 

3 = ID segr^ent address 

4 = ID segment address 

5 = ID segwent address 

6 = ID segment address 



= ASCII prog anne 



<5 para meters passed) 
Cos next o c t value) 
address Co DEF) 
In t4QrU <no DEF addr) 
i n B-Reg< no DEF addr . ) 
in XE61 <no DEF addr.) 
(Next pran is value to 
into B Reg Q s u s p ) 
(passes 5 parameters) 



put 



For exawple 



-0/7/&IO <Four Drivers) 



---I---- ----a- 



— 3 



J SB 


*LI3T 


JSB 


*LIST 


jse 


JLIST 


J SB $LIST aSB 


$LIST 


JSB 


$LIST 


OCT 


00 1 


OCT 


701 


OCT 


60 1 


OCT IXX OCT 


2>\'K 


OCT 


3>(X 


DEF 


R E T R N 


DEF 


RETRH 


OCT 


IDADR 


OCT IDftDR DEF 


P H A M E 


ID 


ADR IN 


OCT 


IDrtDR 


DEF 


PNflHE 


OCT 


BVAL 










DEF 


PRftHl 


DEF 


PRAHi 














DEF 


PRftH2 


DEF 


PRftM2 














DEF 


PRAH3 


DEF 


PRfl«3 




(NO 


INDIRECT DEFS 


! 1 ) 






DEF 


PRAK4 


DEF 


PR«M4 














DEF 


PRAH5 


DEF 


PRAMS 















WORK 
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5 



JSB $LIST 
OCT 4XX 
ID ADR IN 



B REG 



JSB 

OCT 

ID 



$LIST 
5 XX 
ADR IN 



XEQT 
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!^!..!i!! P^J^*^^^^^ ^^^^^^ ^'P the requests shoyn in the coU 



sequencfl into four general cases; 



ng 



Dor«Qnt Request 
Schedule Request 
Operator suspend request 
Non-operator suspend request 
• I/O suspend 

b. Unavailable ffewory suspend 

c. Unavojlable disc space suspend 



a n u n t of error 



s node other 
checking to 



These checks are of the noture 



In general/ beforea coll fn f*»a j-* ^ 

. , , -ST , V I « u tail ZQ tne list processor 

I'jodules have done a considerable 

see if the change is legitiMate. 

'*Does the proqran exist"'? n r >*ua,^^ 4.i^_ 

ranae'"> etc ill } J ^^^ parameters in the proper 

rLf ■ l\ ^^ processor perforns o was - wHi fae check 

That ,s, what was the last state; what will bp 

are the two compatible? If the conpa t i b i 1 i t y ' 

the requested transition is «ade. If the answer is no- then th« 

I'St processor deriri«« rv« »u.* 4.u. •^'wet .^ no., then the 

be 



processor perforns o 

the next state; 
answer is yes. then 
n s w e r 

processor- decides on uhnf fho «%»,.»»» 
ij.. ^ ^ ^ t ws s urf wnai; tn© proper new state will 

add. t, on. one other answer can be .ade The an.Ser Vs ' 

efer" d"" he l\'''^ n'V ' ''' '^ ''' '^ ' ' '^'^ - I tio^to be 
'e^nent ""' ° ''*' ''' deferred action bits in the D 



In 



The transition processing by the list 
folio w s .' 



processor is done as 



Oornant Request 



If 
I . 



the abort bit is set then: 
The 5 temporary 10 segwent words are cleared 

word 9 of the ID seg«ent, and headed at *ZZ2Z in the 

'; ?:i:':Uc.''''^^ '' ^^^^'^''^ ' ''' ^'^' ''^ dispatcher does 

KEQT is cleared (Base Page word 1717) 

The entire status word is cleared ond the CL bit 

If th.s is the currently e><ecuting progran $PUCH ' 

rest counter/ is cleared. 

Link processor is colled to do the list wove 

processor is discussed in the next section. 



^ the privileged 
Link 



- fa 



h e a b r t b i t i 5 n t s e t a n d 

Previous status \s I/O suspend < state 2) or b»t set/ 

then Of, I 'J set D bit and call [ \ nU processor. 

Save resource bit not set then go do Al through ftS above. 

If resource savt bit set and bit not set then ClEftR RI,D 

bits, set status to zei-oj if this is not the currently 

executing progran set the no partaneters bit/ and all link 

p r G c G s s o r , 



Schedule Request 



The schedule request portion of the list processor checks actual 
progroM status infornation in the 10 segwent to see if the program 
isschedulable. 

\)n a schedule a t t e n p t if t }« e program's status is not , 2 .. or 6 

then.' 



H a 



h4 



If dor r^ ant bit setjunp to dormant request processor. 

If the y bit is set/ change the status field to 3 and call 

link processor to put the prograw in the general wait list 

If not I or 2 above set entire status word = I this clears 

other bits; t h en 

Call I i n U processor 



the current s t o t u s is 



to schedule program 
& and 



the 
out all 



Si. OorRont bit set too/ then set stotus to , clear R«.D bitS/ and 

call linU processor to make dormant. 
B2 . (iioit bit set too/ then change status to 3 (general woit) ond 

call link processor to put program into general wait state. 
6 3. Else call link processor to put program in scheduled list. That is 

done A I t hr ug h A4 . 



If the current status is I/O suspend, state 2, 

CI. If bit set. and R or bit set then change status field 

Tf n f f t • ^'"1^ processor to wake program -.aerator suspended 
^2- ^r "^ ^'* set jump to dornant re q ue st processor . P^naea. 

if the current status is 0. that is. first despatch, then! 



01 



D3 



Perform, CI and C2 in case the program was in the tlNe list 
L. on bS coMwand set the bit. 



and 



ChecU to see if the prograR is disc resident. If so. then chect< 
the proper IHATA table entry to see If the program terminated 
saving resources or serially reusable and is still i the 
partition. If no go do Al - rt4 . 

If ^til in partition then call the dispatcher routine *DM«L 
to set the partition up to be reused. Then go do Al - A4 . 



LIST CALLS BY DRIVERS 



Certain $LIST calls have been set aside for use 
list calls With function codes of 



JSB 
OCT 
0EF 
OCT 
DEF 
DEF 
DEF 
DEF 
DEF 



fLIST 

001 

RETRH 

IDrtDR 

PR^Mi 

PRrtM2 

PR^M3 

PR«H4 

PRA«5 



JSB 
OCT 
OEF 
DEF 
OEf 
DEF 
DEF 
DEF 
DEF 



0, 6. 

$LIST 

701 

RETRN 

PNAHE 

PRAHI 

PRAM2 

PRAM3 

PRAH4 

PRAH5 



and 7 



by drivers. 
The for Pi of 



These ore 
the call is 



^SB $LIS7 

OCT 601 

OCT IDADR 

OCT BVAL 



For function codes of and 7 up to 5 parameters may be passed At 
least one parameter must be sueoIipH Th^ s^ ..^ 1 P°^^®° "* 

th- XTFNP ^^o, r.i> 4.U T^ suppi,ed. The five paraneters are put into 
the XTEMP area of the ID segment and may be picked up by calling RMPAR 

The DEF RETRN must delimit the parameters and no Indirect DEF^s ... 

For function code ofl, the ID address (IDflDR) must be in the 

points to a 3 word array containing 
ion code 6 BVflL is placed in word II 
regtster at suspension. 



€ UfcF RETRN must del imit the 
a I lowed 
call. For function code of 7 



the ASCII 

of the ID 



PMAM 



program name 
segment/ the 



For f u n c t 



B 



Only schedule requests 
that $LIST does almost 
the op systew. It 
are d o i n q . 



I s 



«Qy be made. No other requests are allowed Note 
no error checking f or dr 
assumed thot if you 



ivers and none for 
call $LIST you know what 



you 
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Operator Suspend Request 



El . 

E2 . 
£3 . 



E4 . 



If the entire status word is and the progran is not in the tine list 

or the status field = 6/ then natje an "Illegal Status" error return. 

If current status field - 2,. I/O suspend, then set bit. 

If status field = <i.e. other bits =0) then set R&D bits. 

Ma)<e status field = 6/ and call linU processor to wake list 

MO ve . 

If not 1/2 or 3 above set status to 6 and call link processor. 



H<if\ Operator Suspend Request 

1. Put requested future stotus into status field of progran's ID 
segment saving all the upper bits of the sone word. 

2. Call link processor to Rake list transition. 

Onreturnfron$LIST 

A = neans success 

B = ID address of progran referenced 

else 



A = rtSCI! error code address and 

B - nun eric error code 

s 3 Means illegal status (not dormant) 

= 5 no such progran 



LINK PROCESSOR 



The RErtl TIME EXECUTIVE "LIHK PROCESSOR" 
progrQM fro« one list to add the prograw 



function i 
to another 



to r en ove 
list. 



When \r 
s 1 t u s 
s u s p € n 
<RTIOC 
refto va 
the I / 
c o rt p u t 
list. 

list/ 

s h u Id 
t n lis 



e « o V i n g 
to see 
d list is 
Thus / 
portion of 



p r g r a n 
I/O 



a progran frow a list, q check is nade of the 
if it is in the I/O suspend list. NOTE? The 

not kept in SCHED. but is kept by I/O processor 
if the progran is in I/O suspend list/ the progran 
the routine is bypassed. If progran is not in 
suspend state, the rewoval request code value is used to 
the address of the "top of list" word for the particulor 
If the progran connot be found in the list; or it is a null 
the progran returns as if the action hos been perforned. Th 

be an iftpossible case. Assuming that the program is found 
t, the action token deper\ds on where the progran is in the I 



i s 



s t 



- 1 - 

The r ? n '3 V 1 1 of p r -: g r <i m ^ r o r a list c o r> s i s t s o f J 

1 . If I / C list ( c o d €■ 2 1 .. t n e n 'i h i s * s s p e c i ft I case and does not 

r e q 'i i r e r e n o v q I 

2 - If HULL list.- t h •? n error e x t t t a U € n . 

j If first and g n I y prog res w in list/ then list value set to zero. 

4 If first prog raw in list/ but not the only progrcM in list 

(linU^ige not zero)/ then set list value to the linttage value. 

if in Middle of list/ the linUage of the 10 segment which points 
to the program to be renoved is Sf3t to th© linkage value of the 
progrciPithatisrefiov^^d. 

o If last progron in list/ the linkage value of previous program 
! n list is set to zero. 



.-tfter the program has completed the renovftl portion of the rout in©/ 
,t con then be added to another list. The addition code value is 
e/, anined to see if it is to be added to I/O suspend list* in which 
case return is ftade to calling progrod. Otherwise/ the addition 
request codt value is used to conpute the oddress ofthe "top of 
iist" word for the particular list. Programs are added to a list 
according to priority The progran is added to the list just prior 
to the progran of lower priority. The progran is added to the list 
if. the following wanner; 



If I/O list (code 
wade to list. 



then this is special caseond no oddition 



If HULL l^st/ then list value set to pointto idsegwent or pro- 
gran to be added and the linkage set to zero. 

If not null list/ the progran is insert e d into list according to 
priority level and linkages changtd to reflect thisinsertion. 

If a lower pi*' or., than any progran in list/ then last linkage 
is set to point to the p r o g r o n to be added an d the prograw 
linkag^iscleared. 
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3. Hessaqe Processor 

The operator Input nessage processor/ fHESS* accepts input coMjiands 
progranot I CO I I M/ generally through the systew library routine HESSS 
or fron the syste« console via the *TYPE routine. 

The *TYPE routine is entered by on interrupt created wj the operotor 

striding any key on the systen teletype. Upon entry, the systen 

teletype ready flag is chectted for busy. If the flag is busy. 

then control is given to $XEQ, If the flag is zero, then an * 

< asterisk) is output to syste« teletype via IXSIO and a request 

for teletype input is nade to the syste« teletype vio $XSIO with 

the completion addr ess T YP I . The s y s t en t e le type flag is set 

and control given to $XEG. When the operator hos input his request 

<signified by LF>, the operotor Message processor routine <*MESS) 

is colled. Upon return fron IHESS/ the A register is checked for 

zero or non-zero. If non~zero/ then o nessage is to be output 

irofi $MESS on the systen teletype. The A register contains the 

address of the buffer which contoins the Message. The first word of 

this buffer contains the nunber of characters to be output and the 

ASCII message begins at the next word. This wessage is output 

via IXSIO and teletype busy flag is cleared ond control given to *XEQ 

If the ft register is zero upon return fron $M€SS/ the teletype flag 

is cleared and control given to $XEQ. 



The entry point $ttESS 
the actual processing 



is in Table 
itself. It 



Area I . It 
c o n t a ins .' 



is a front end to 



IHESS HOP 
SSM 

S vl P 



$MEU 
$«SGP 



The entry point $HEU will then contain the 
when the IMESS call was wade. This status 
$HESS returns. 



DHS status of the systen 
Will be restored when 



tHESS is not a closed subroutine. For exanple, the OF connond will cause 
a progran to be aborted and the associated clean up code to be executed. 
The return is to the dispatcher not to the caller of $HESS. 
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The fonowirtQ things are done for calls to *MESSJ 

i. The coMMond's existence is verified. 

2. The connand is parsed. 

3. The conwond is dispatched. 

The first of these operations is done by checking the transnission 
log. If zero characters were received . $MESS .just e^its. 

If. upon entry to * HE S S / c h or ac t er count is non zero then the 
internal parsing routine is colled and parses the entire operator 
input. The output of the parse routine is a 33 wordinternol 
buffer. The calling sequence ond two exawples ore shown below! 

The Parsing routine scons the ASCII input buffer and stores the 

data into paraneter tables. Connas are used to flag separation 

of parameters. The character count fron teletype driver is assu«ed 
to be in the B register upon entry. 



A paraneter noy be up to six ASCII characters in length. There 
May be up to s even par owe ters and one operation code input with a 
rtoxiwuM of eighty characters. As the input is sconned. a count of 
poraneters and count of characters for each paroneter is Itept. 
Characters are stored left adjusted in the buffer yord PARAM 
contoins the poraneter count and 0P.Pl,....P7 contains the ASCII 
paraweter volues. The character count for each parage ter is kept 
in word .just prior to buffers. PARAM is kept as positive integer and 
character counts >ire negotive integers. 
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SYSTEM FhRSE ROUTINE 
C a I I <: rr g sequence; 



J38 $PrtRS 
UEF PBUFR 



3 3 word buffer for parsed output 



A - R E G = i n p u t b u f f e r d d r e 5 s 

3 "REG = positive choracter count 

The parse routine ysli. accept up to 8 parameters deli Ritedby 
coHMos Each parameter is parsed into A words «here the first 
worddescr, bes the type of paraneter. The forwat is shown belowi 

WORD » I CONTENTS 

1 (TYPE) } .f null, I if miner ic, 2 if rtSCII 

2 I binary 9 if type - I, 1st two ^SCII char's if type = 2 

3 I used far ASCII only = 2nd two ASCII characters 
I 

4 I used forASU only = 3rd two ASCII characters 



E X a M p I e ! 

PQ, P Q RST;55,/I0B/5 5€377M/ABC0EFGHIJ 

Notes: 

1 . All blanks are ignored. 

2 Any ASCII characters past 
the first 6are ignored 

3 . To enter' ASCII 77 enter 

.' ? 7 A > w h e r e X is 
any ASCII character 
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After the cowHand is parsed its exi stance «ust be verified. This 
is done by a table look up. The Table is ot LDOPC and is just a 
siwple list of ASCII opcodes. If the opcode is valid/ then a 
junp is node through table LD^-iMP. Each entry in LOOPC has a 
corresponding entry on LDJIiP. LDJMP contains the address of the 
various processors. Note how easy this waUes adding -^ew conwands 
One nerely places the ftSCII opcode into LDOPC and the oddress of 
theprocessorintoLDJHP. 



Connonds not in the table are dispatched to 
returns the proper error. 



r out i ne wh i ch 



Errors are returned to the caller of IMESS to be printed in the 
proper place <or not atall). Recall that fMESS can be colled fron 
a progron via MESSS (seethe library section of your nonual. 

4 . SYSTEH START UP 



yhen the user pushesthe run button the final tine on systen boot 
up a junpis «ade to the *STRT routine in the scheduler. $STRT's 
is to get the syste« going. This section of code is executed 
onceandisloteroverlayed. 



j ob 



The first thing that the start 
ihesystenwap. 



up routine does is to set up 



To begin 
«o p none 



wi th the f irst 32K 
of which/ to begin 



of physicol menory will bet he systew 
with.* will bewrite protected. A 
J3B is then HOtde to ICNFG/ the slow boot routine. This will allow 
the user to reconfigure system available Menory.. I/O., and partitions. 
After this the slow boot returns to $STRT so that set up of the 
systen Hap can be finished. This napping routine uses the following 
information oboutsysten available wenory. 



1st PHYSICAL •^CHUNK" of SAM 



$HPSft 

BP 1660 
8P 1661 



15 

I # nr PAGES 



10 9 

{ PHYSICAL START PAGE I 



LOGICAL START ADDRESS 
HUHBER OF WORDS 



n d P H V 3 i C A L " C H U H K " OF SAM 



$HPS2 



10 
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« OF PAuES 



( PHYSICAL START PftGE I 



BP 


1662 


SP 


166 3 


BP 


16 6 4 


BP 


1 66 5 


BP 


166 6 


BP 


166? 


BP 


i6?0 


BP 


1671 



LOGICAL START ADDRESS 
HUHB£P OF WQRDS 
LOGICAL START ADDRESS 
NUMBER OF WORDS 
LOGICAL START ADDRESS 
NUMBER OF JJORDS 
LOGICAL START ADDRESS 
NUMBER OF WORDS 



The f \ r 3t area of S A fl / which is q n i n i w jj p* of 2 pages, is set up 
bij the q e ft e r Q t r and does not change. P h y s i c a U y ' : t is located 
directly behind the operating stjStePi The second ar^ea 5 set 
■it genera t i on t i Ns but is chargoble via $CNFG at boot up. It 
phys'CQlly resides oft^r the neRory resident pro gran area <i. 
before the first prograw partition). 



up 



Note t h c t the second area is divided into four pieces. T h 
ailo«s the user <yith the slow boot) to wort< his way around 
p a q e i of r e ft o r y that m ti y ? x i s t within 3 .^ f1 . 



s 
any 



bad 



yhile the two areas are not physically contigious/ they will be nade 
logically contigious. This is done by taUing the physical page 
numbers of both areas of SAH and placing these nuNfaers contigiously 



into the D ftl> r e :j i s t e r s c o i^ r e s p o n d i n g to their logical address in 
system nap $RTH.. the system available wenory return routine is 
then called ot leost twice to fill up SAM with the now cont 



the 
i g j o u s n e ri r y 



y h e n this calculation is c o n p I e t e the s y s t e n 
i t « u I d look as shown below. 



wop 



reset. Typically 
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The $STRT routine also initializes the contents of a few systen 
entry points for later use by other s y s te w wodu I e s . The folioMing 
entrypointsareset. 



:f C H S T 



$ C M L 



ISOrt 



Starting page of connon. 

Hots that logical and physical pages are the sane for 

$ c n s T . 

*CflST =^ bits 14-10 of $DLP shifted down 

$OLP - disc resident progran load point set up by generator 

Hunber of pages of conwon 

fCOMl - bits 14-10 shifteddown of CMPFI (.3) + BGC0H-$DLP3 
and then add I to this result. 

Where: BGCOH = base page 1753 length of backround cowHon 
MPFK33 = fourth entry in MeMory protect fence 
table. Start of backround cow won. 

Starting page of systen driver area. 
$SOA = ICHST •)• $COMl 

Hote that logical and physical pages are the samefor 
$SDA . 



*SDT2 



HuMber of pages occupied by the systen driver area 

and table area 2. 

$SDT2= Bits 14-10 shifted down of $PLD-fSDfl 

Where! *PLD is the privileged program load point set 

bythegenerator. 



up 



$ P. L B 



Logical starting page of the nenory resident librory. 
*RLB = bits 14-10 shifted down of LB ORG (Base Page 
location l?*45;i LBORG is the address of the library set 
b y t h e g e n e r a t r . 



$fUW 



Hu fiber of pages in newory resident library 
fRLH = bits 14-10 shifted down of EMPFKl) 



LBORG] 



After initializing these values $STRT calls the $ZZZ2 routine in the 
dispatcher. At this tine XEQT is cleared; the interrupt systeis i^ 
cleared; the neNory protect fence register is set to 0, sMap delay 
is set up; a checl^ is «ade to see if there are backround, real tiMe. 
and chained partitions and if not the partition list headers are 
reset, and Ustly FHGR is scheduled. This section of code i^ only 
executed once and is later overlayed. A return is node to $RTRT " 



The last thing $STRT does is pick up the ID address of FHQR , D.RTR, 
and SMP. These addresses are used later by the system for 
various types of error checking. $STRT then junps to the EXEC to 
finish the system start up . 

E/5EC also saves D.RTR's address for error checking so that tts 
disc tracks are not released improperly by the user. EKEC ten 
ju«ps to $CGRN in the ITRRN Module to set up the resource number 
table. A last .junp is node then to $3CLK in RTIME to start up the 
r e a I t i n e c 1 c k . 

The ISCLK routine starts the tine base generator, uses the RTIOC 
routine * 5 Y M G to print out 'SET 



in the dispatcher. The system 
5. EXEC REQUEST HANDLERS 



TIME' and lastly .; u n p s to $ M E Q 
s now ready to qo. 



Current I y t here 
They are; 



are eleven EXEC REQUESTS involved in the scheduler 



EXEC REQUEST « 



PURPOSE 



ENTRY POINT 



9 

10 
I I 

1 



Z> 1 

23 

24 



Program Completion 

P r q K- a ri Suspend 

Load Backround Program 

S e g P! e n t 

Schedule w / w a i t 

Schedule w/o wait 

Systen Time Request 

Schedule at absolute tine 

or with tine offset 

GET or put string 

Program Swap Control 

Schedule w / o.i a i t and « / queue 

Schedule w/o wait and w / q u e u e 



$(1PT1 


$ (1 P T 2 


* M P T 3 


$(1PT4 


$ H P T 5 


* M P T 6 * 


* ri P T 7 * 


« ri P T 9 


$MPT8 


* M P T 4 


*I1PT5 



The processing 
RTIME. 



of these requests is shared with the systen module 
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Cinn be seen i-r<in the table above nany of the requests u 1 1 i n q t e t y 
deal with the list processor. In general, the processors pull 
in the request pa ro Meters locaUy. check the« for validity., and 
if the parameters are valid/ a coll to the list processor is 
wade. 



Four of these request are briefly discussed here. The other 
requests are discussed in con. junction with other scheduler functions 

PR OG 15 AN SUSPEND REQUEST 



This is an EM EC 7 Request, The processor first checP. s the program's 
botch bit. If set/ an SCOO error \s generated and the program aborted. 
This is because prograMS under botch way not be suspended," If clear/ $ALD 
whiCh is a dispatcher' subroutine that will nove the partition out oft he 
allocated list and into the dormant list/ is called. Lastly/ ILIST 
is called to operator suspend the program, 

SEGMENT LOAD REQUEST 



This is an EKEC 8 request. The processor first looks at the request 
count. If bad an SCO I error is generated. If OK the system subroutine 
THAHE is called to get the ID address of the segnent. Ifit is not 
found on 3 C 5 error is generated. The entry point a d d r e s s o f the 
segment is then fetched a n d f> a d e t h e return address of the s e g n e n t 
load E/\EC call -I BRED in the dispatcher is called to do the actual 
load. Any p a r a r-f e t e r s that are to be passed are placed in the 
tenporary words of the ID segnent. Control is then transfered to 
i* M E Q . 
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SYSTEPl TIME REQUEST 



This is an EXEC II request. It returns the current systen tine. 
The tfwe is l^ept in two words. <-$TII1E cincJ<TIME + l) in Table Area 
2. Each bit corresponds to 10 HSEC with the west significant 
bits in the upper byte of the second word. 

The scheduler checksthe input paraneters for errors f picks up the 
ii«e words ond turns the rest of the processing over to the 
*TII1V routine in the RTINE Module. $TI«V tokes the words and 
forntits theM into hours, doys/ Minutes ond lOths of MSECs. 

TiHE SCHEDULE REQUEST 



OnUj the request count and resolution codes are checked in the 
scheduler. GETID is called to get the programs ID address. All 
other processing s turned over to ITIMR in the RTINE nodule. 



- 2 - 

i f\ RTE IV there are 9 ways q user tnay terminate htsprogran. In 
addition., the systen way abort programs too. The user has three 
variations of the OF c o n n a n d / . f i v e variations of the EXEC 6 
request, and the EXEC 12 REQUEST. Sone of these r^ay be grouped/ 
ho<*e veri in terms of what the system does. 

I . TYPE 1 SOFT ABORT 
a. OF. PROG 
b . CALL EXEC < 6/ 0,2 ) 



3 . 



TYPE 2 HARD ABORT 

a . OF , PROG/ I 

b. CALL EXEC < 6/0/3. 1 

c. SYSTEH ABORT 

TYPE 3 Renove progran fron Systen 
a. OF/PROG, 3 



TYPE 4 TERHINATE SAVING 

a. CALL EXEC <6.. O/l) 

b. CALL EXEC < 12/ . . . ) 



RESOURCES 



5. TYPE 5 TERMINATE SERIALLY REUSABLE 
a . Can EXEC < 6/ 0/-i ) 

6. TYPE 6 NORMAL PROaRAHATIC COMPLETION 
. CALL EXEC < 6/ /O ) 



ye shall discuss each of these types 
systen processing requirerrents. 



in the order of increased 



The type 6/ normal conpletion request/ requires the least processing 
and is by far the nost connon of progran terninattcns. It is Mostly 
don^ in the scheduler TERM subroutine. 



Th€ TERM 
If the fa 
then t h e 
and if he 
h j P5 . It 
3 . This 
f a i; h e r « a 
bit se t . 
3 . Fo r 
should be 
the 'W b 



routine first calls the list processor to put the progran dornant 

ther's Molting bit <Ftf) is set for this prograw/ 

systen finds the father and clears his 'W bit which was set.1 

is in state 3/ the list processor is called to schedule 
is possible that the father is waiting but is not in state 
would indicate that he is possibly dornant because his 
de hifl dorwant or that he is in another state with the 'W' 

For this reason he is rescheduled only if he is in state 
ther cases the list processor picUs up the fact thot he 

scheduled by the indication that was left fay clearing 
it. The TERM routine then clears all but the "RH'*/''RE**/ 
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"Py and "RN" bits in words 21 of the progrow being put dornont/ 
and returns. The RN bit of the ID segnent i nd » ca tes that the 
progrckrt hos resourcenuRbers. The RH flag indicates that it 
has re-entrant Re«ory that has been waved. These resources will 
be released by DISPA when it finds the progran linked into the 
abort list at "fZZZZ" Prefer to Appendix B for a description of 
th i s process 3 . 

The last thing to happen in the normal terwination is that any 
optional paroweters supplied in the terninotion request are placed 
in the 5 word tenporary word of the ID segnent. This ollows the 
original schedu I i ng parane t er s (or any others) to be picked up 
With the systen subroutine RMPAR. 

This is the niniRun processing for progran conpletion. 



The Type 1/ soft obort termination/ requires a 
The soft obort starts with o call to theSflBRT 
scheduler. 



little wore processing 
subroutine in the 



The first thing S«BRT does is to clearthe 'R' ond D bit in the 

status word. This will force the list processor ($LIST> to truly 

put the progran dormant. The system then calls *TREH <in RTIME)/ 

which will remove the program from the time list. This clears the 
IDsegnentsTbit. 

The U bit is checlied n-ext, if set then this program is a father 
waiting for a son. (Recall that son's 10 oddress is in word 2 
of fathers ID segnent.) In this case the sons FW bit is cleared. 
This insures proper processing when the son terminates. 

The TERM subroutine* described earlier is next called. 

Lastly the SflBRT routine checks to see if this progran is the son 
of another progran. If so then a lOOOO'OB is placed into word 
2 of the fathers ID segment and the address of word 2 is placed 
into word 11/ the B register at suspension word. This allows the 
father to do o RMPAR call and to get back o word (the first of 
5) that indicates that the son progran was aborted. This is how 
FHCR. for example/ tsnows to generate the "ABEND XXXKX ABORTED" 
message. 



Next in order of processing is type 2/ the hard abort. The hard 

abort is performed in thelABRT subroutine. However/ before calling 

this routine a check is made of the progrons current status. 

If the status is I/O suspend <stote 2.^ a jump is made to the RTIOC 

routinellOCL. 



Briefly/ IIOCL CLEARS out any 'hong up' conditions coused by pr ograw 
input or output. It scans oil the EQT's I/O linl-ied lists lool^ing 
to see if the progrctn is in the list. <LinUed through firstword 
in ID segnent). If any I/O is found the progrow is delinl<ed and 
the I/O cleared. $IOCL then calls fABRT to finish the abort. 



fy^BRT sets the abort 



("rt"> bit in the prog rows status 
we discussed this bit in the *LIST discu-ssion) 
set indicates a hard abort to $LIST and forces 
program dornont. *<^BRT then calls SA8RT which 

*h8RT then colls $SORL in EXEC which releases _^ _.__ ,. ... 

progran owns. and.» if any are released/ calls $LIST to schedule all 
prograns waiting for disc tracks. The exception here is thot $SDRL 
will not release tracks belonging to O.RTR. After *SDRL returns/ 
$ABRT sets up the program abort nessage and sends 
RTIOC which will send it t-o the systew console. 



word »^ r ■> c a I I 
The "A" bit be i ng 
it to set the 
we just discussed, 
any disc t r o c k s the 



that 



t to $SYHG in 



Hei^t in order of processing is the power abort- type 3. NorNolly 
this is not done progroMnaticolly (call to $HESS!'/ it is done 
with the OF connand. The power abort calls$ABRT to do the hard 
abort first. The TM bit is next checked if the TM bit is set/ it 
indicates thot the program was loaded temporarily online., and there 
is no copyof its ID-segnent on the disc. Only in this cose can 
the OF processor clear the ID segwent. The rest of the OF code 
conputes the number and location of the tracks holding the pro gran 
(words 23-2? of the ID segment) calls $DREL in EXEC to release the 
tracks. The OF request assunes on ID segment owns a track only 
if it references sector on that track. This convention prevents 
double releose of tracks in cases where background segnents stort 
in the Middle of o track. Furhternore/ $DREL will only release 
the tracks if they are owned by the system <i.e./ it will not 
iree FMP tracks). $DREL also reschedules any pr ogr a ns wa f t i ng for 
d»sc tracks by calling $LIST. 



When $DREL returns/ the OF routine clears the 3 name words (except 
for the SS bit/ which indicates o short ID-segnent; and the track 
assignment words. V. it releases ony EMA ID extension; and then goes 



to *X£ 



The type 4 .• saye resources termination is a special case of the 
normal termination. In this case the dispatcher subroutine $ALOH 
is celled. This routine unlinks the partition the progran executed 
in from the allocated list and puts the partition into the dornant 
list. The IHATA entry D fait is gIso set. Hext the R bit in the 
ID segment is set. This is done so that the list processor will 
not put the program in the clean up stack headed at IZZ2Z. (Refer 
to Appendix B :» <*LIST will clear the R b i t ;i . 
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Now if this case is a father terninating his son then all that 
is left to do is a. $LIST coll to place the program dor Mint. The 
More general case., however / is the prog ^a^1 terminating itself. 

In this cose the -HWATR routine is called. All IWATR does is 
ch«cU' the PW bit to see if any other progrow wants lo schedule 
this progrQN that is doing the save resources terwinotion. If 
the bit is set then a search of the general wait list iS wade to 
see who is waiting. (Recall word 2 of the waiting progran 
will have the prospective son's ID address. The prospective son 
is now doing the save resources termination). If the prospective 
f other can b<? found a $LIST call is node to reschedule hin. This 
allows the schedule request to be reissued. The rest of the 
processing is done exactly like the nornal prpgraw terwinotion. 



Lastly 
to na k 
r e u s G b 
the pr 
called 
M o r d i 
to App 
free 1 
Last I M 
s e g N e n 



there 
e sure 
le . If 
g r a R i 

He 
s set 
end! X 
i s t 

any 



t 
a 
B 
$ 
op 



t t ewpo 



is the serially reusable completion. A check is nade 
a father is not trying to terninate a son as seriolly 

this is detected c norwal ternination results. If 
s terninating itself then the TERM subroutine is 

the least significont bit of the father ID nuwber 
s a flag to the dispatcher clean up routine <refer 
.) that the programs partition is not to be put in the 
ALDM is then called to take care of the partition, 
tional paraweters supplied are placed in the ID 
r a r y area. 



PROGRAM SCHEDULING 

■fhere are four ways to schedule a prograw in RTE IV. The prog ran 
can be. scheduled by tine,, event* operotor conwandj- or another 
p r g r a M , 



To schedule a program by tiwe the program Rust have been in the 
ti«e list already <This wot; Id require theoperator ON request 
earlier). Every tine the tifie base generator interrupts control 
is t r a n s f p r e d to t b e $ C L C K routine in the R T I M E Module Here 
every progran in the tine list (threaded through ID word 17 > is 
c h e c l{ e d to see if it is t i ^ e to e >; e c u t e . If words 19 ?4 20 of the 
10 seg>!ent equal the systen tine stored at -ITIME i $TIHE+l and if 
the proqror^ is dor m ant., o coll is Nads to the list processor to 
schedule the program. Re'^ordless of prog raw state., the next 
start tine is c a I c u 1 a t e d a n d stored bod; into the ID segment. 
< T h e new t i n e is not c o m p u t e d if t h 9 h u 1 1 i d 1 e value is . "5" h i s 
neons the p r o g r a n is to be t" e m o v <? d f r o m the tiwe list.) 
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:• 'I n e d <i. \ i '■' q by event i s t >i : : c a I i ij d o »i e by drivers. D V R and 
O'ROS ft- ex aripl'?, schedule t- ho prog row PR HPT due to an event/ 
tfi ot >s, an interrupt rh i ? scheduling is done by a $1.1 ST call. 

The ON and P. U c o « n q n d > a r ■? o n o t. h e r way to schedule a p r o g r a "i . These 
t''Jo coMHQndsdiffer in that the RU connand will schedule q progr^aft 
n c< '< r e q ti r d I e 5 s of the t s h e list p ci r a ri e t e r s . The ON command s 
capable of putting a prog ran in the time list and/ or scheduling 
the progrofi ir» Mediately. {» both cases a coll isnade to ILIST 
to do thescheduuing 

Before the $!. 1ST call is Made the progroM is checked to see if it 
is dornont. Jf not an ''illegal status" wessage is returned. If 
the ■' IH ' was not entered in the schedule coMwand and paraneters ore 
allowed on schedule <i.e NP bit Clear)/ then any paraweters supplied 
wtth the cownand ore put into a string block in system available 
f'lenory The ftrst five of the paroneters ore placed into the tenporary 
uords of the ID segnent. (String processing is discu.-ssed in the 
next section) In the ca?e of the RU cownand the ILiST coll is 
made next and that's the end of the RU processing. 

The ON processor looks at the programs ID seginent resolution code 
to determine the next process. If the resolution code is 0/ only 
$LIST call is wade. If the resolution code is not then 
the lOHTIi processor in RTIME finishes the processing. Basically 
fOHTH checks for the NO (HOy) in the coftMond. If present then 
the prograf'i is put »nto the tine list and e.xecutes at the current 
systew t i we and tO r i Me sec onds . If the HO \s obsent $0H7M places 
the pj'ogran into the tiwe list. The progru:^ then e.xecutes ot the 
t i ?i e specified in words 19 and 20 of it's ID s e g n e n t . 

The last way to schedule a pro gran is progranr«atically '-EXEC 9/ 
10.. 2 3 ond 24 requests). The processing here is sonewhat More 
involved than the ON or RU cowwands because o father son relation- 
ship is involved. Host of the processing is done in the I D C H K 
subroutine The r o « t i n e d o e s the following 



■', 


11 a k es sur e ,th e pr 


2 . 


Hakes sure the na 




generates an SC0 5 


z 


Hakes sure the \ir 




in., else generate 


4 . 


Places perspectiv 




the perspective f 


5 . 


Calls the string 




= no string pas 


<'\ 


Hakes sur*? that t 




are put ; n t o the 



oqran €fMists.. else generates an SC05 error, 
ne specified is not a segwent nawe.. else 

error . 
oqraw will find a partition large enough to execute 
3 a n 5 C g r S C C <i 8 e r r r . 

e son's HP bit and hits 0-3 of s t o t u s field into 
other's A-Register at suspension word. 
passing routines if necessary. (i.e., if RQP9 
Sing ) 

he first five optional scheduling parameters 
sonsH'tenporarywords. 
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For exec 3, 10. 23/ and 24 requests., the R\i , OH.- SZ ond *^S cownands^ the 
3IZIT subroutine is called to see if o partition exists thatis large 
enough to execute the program. Thus insuring that a progran scheduled 
is dispotchable. For wenory resident programs the checU Is ignored. 



For non EMA programs the check uses the# of 
ID segment and compares this against? 



pages field,, word 22/ of the 



# of pages < *MBGP if the progran is bockground 

# of page.s < $I1RTP if the progran is real tiwe 

Alternatively/ if the progran is as.signed to a partition 
IDsegp^ent set) then the partition * field is used as an 



< R P bit In 
Index into 



the 



$HATrt table to see if thedestlnationpart 
for the progran and if the partition is st 
already in Memory with an allocated par tit 



tion is lorgeenough 

11 defined. <Hot© progrons 

on Noij not have their 



sizes changed. The SZ operator request error check routine guards 
a g a i n s t t h i s . ) 



It nay 
space . 
used. 



also happen that IflBGP or 
In this case the check 4) 



$MRTP is 
of pages 



larger than a 
< HAX ADDRESS 



32 K address 
SPACE is 



H the progroR is an EHA progran / the following check is used. 

« OF PAGES - HSEG + EPtA SIZE < $HCHN OR ASSIGNED PARTITION SIZE 



where MSEC is in word 
ID segwent/ and 



I of the ID extension/ EMfl size is 
*HCHAH is the size of the largest I 



in word 29 
other Port 



of the 
t I on . 



If the check foils on SC09 or SC<i8 error (SIZE ERROR) will result. 
However/ if the DE bit (EdA default) is set then the EMA size is reset to 
and the check is performed again. If the check now passes all is well 
and the EMA size of I will be used by the dispatcher as a flag to give 
the prograwf the lorgest possible EHA size. 

If the reader has alreody read the sections on the AS end SZ coH«ftn ds/ 
the question nay co«e up "Why check for size/ this is already done in 
the 10 ADR and for on line cownands?" the reason is that the FMGR 'SP' 
and 'RP' com wands allow the user to sove programs whose size or 
assignment may not natch the currently defined partitions. The 
error checking prevents a Niswatch of progran and partition fron 
causing systen problens. 

NOTE thot every time a progran is scheduled «f1CHH/ $HBGP or 

$HRTP <or the destination partition size.) is used as a check to see if 

the program can fit into a partition. If *MCHH/ $MRTP or $HBGP = 0/ 

then no partitions of that type is available and the program Is not 
dispatchable. This may happen if a parity error causes a partition 

or partitions to become undefined. Should the scheduler detect this 

cortd i t i on / the program will not be scheduled ond an SC08/ SC09/ or 
'SIZE ERROR' will be reported to the systen console. 
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STRING PASSING 



Upon scheduling 

of 

of 



^ prograw with the RU, ON or GO connonds. a section 
of systew-QVQi Uble-nenory (SAM) will be allocated for storage 



of any conmand string and entered in a push down stack linked through 
the f.rst word of each bloclt (see Figure l). The head of the stacK 
w.U have the name ISTRG and reside in the SCHED nodule. A ro„„and 



string is defined as everything following 
call. 



the pronpt in a scheduling 



If the progron is scheduled by a RUIH.ONIH, or GOIH, then thp strinq 
storage portion of the cownond will be inhibited. The first word 
of ejich blocl^ of «enory will contain a pointer to the next newory 
bl<icU. The lost block of nenory in the stock will contain in 
its link word. The second word of each block of nenory will 
contain the ID address of the scheduled program. The sign bit; 
when set/ will indicate that the nenory block hos an additional 
word <see systen description of the menory allocation routine. 
< * A L C ) . 

The third word of each block will contain the character count of 
the cop»«and string. The fourth through N+l +3 words will contain 



the N characters in the connond string 



Upon scheduling a prograw with the RU.. OH or GO coMWond/ 
following steps will occur q t p q r Ci m e t e r s t o r o g e t i m e J 



the 



1. If there is no parorteter string., continue Qt Step 5. 

2. Store porsed parameters into ID segwent words 2 to 6as before. 

3. If the COM wand is RUIH/ ONIH or GQIH then do not stnre para Meter 
stringcindcontinueOitS. 

4 Deallocate any string blocl<<s) associated with the scheduled 
p r o q r a M . 

Allocate a blacU fronSflM/ store the entire conmand string 
into the bloci'; and enter it into the stack. If SAH is not 
available, then the request is ignored^ the following error 
Message is issued to the operator's terminal] 

CMD IGNORED - HO MEP1 

and control is returned to the systew at $XEQ. 
5. Sched u I e t he pr ogr a« f or execu t t on . 

The user can retrieve the string by using the EXEC 14 request or 
thesysten library routine GETST. Both routines release the string 
wenory back to the systen. Alternately/ pro grans can still recover 
the first five paraweters < treated as one cowputer word each) by 
using the RMPAR coll asthe first call in the prograw. 



Any time a prograN goes dormant/ normally or abnorrially/ 
string block assigned to the program will be returned to 
is accoHplrshed in the ABORT routine of the dispatcher. 

SCHEDULER INTERFACE WITH DISPATCHER 



any comnand 
SAM. Thi s 



Several portions of the scheduler interface to the dispatcher. 
The list processor portion of the scheduler interfaces on prograw 
scheduling. The list processor also 

interfaces with the dispotcher on program conpletltlon as described 
in Appendix B. In addition, the OR. AS and SZ operator conwands 



affect the dispatchabllity of a program 
connands is discussed below. 



The error checking for these 



The AS and 32 both require theprogranreferenced tobe dormant and not 

fie«ory resident. Horeover, the prograw nust not still own the last 

partition in which it executed. (Recall that a serial reusable,, save resour< 

termination/ ope rotor suspension does not release the partition.) 

The partition # field of word 22 is used as on indeM into the «HATA 

and the $MftTA residency word is checked to noke sur-9 the referenced 

no longer owns the partition. If any of these conditions are not 

met the "ILLEGAL STATUS HE S SAGE" Is output. 



table 
p r o g r a M 
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So«e other error checking, \s performed for the flS coNnond The 
Partition Must exist and the size of the progra« is checked against 
the Size of the referenced partition. For non EMA progrows the « of 
p<iqes field is conpared against and «ust not be greater than the 
partftions IHATA entry. For EMrt prograns the fornuU used is! 

# of Pages - MSEC SIZE + EWft SIZE < MOTHER PARTITION SIZE 



wheref MSEC SIZE is in word I of the ID extension. Eflft SIZE is in 

word 29 of the ID segwent. and HOTHER PARTITION SIZE is in the 

I ?1 A T rt t a b I e . 

EHA proqT<iP^s nay be assigned to regular partitions in additinn to 
chained ones. The size check formula used in this case is 

# OF PAQES - MSEG+EWA SIZE < PARTITION SIZE 

If at the ^nd of qU the error checking, the AS connand is deternlned 
to be valid, then the RP bit is set and the partition t is set into 
p a r t i t i n # f i e I d , 

(Partitions count fron 0. That is; AS.PROGX,? will result in a 
6 being placed into the partition « field.) 

Th€ SZ cowwand processor performs the progran partition and size checks 
Mentioned earlier plus a few nore. Word 30 of the progran ID 
segment for segmented programs or word 24 for non segmented programs 
IS used as the lower Mmit of the error check. The upper limit 
is 6^f i ned by the program type as follows: 

new 3IZE-K $«BGP for backround programs 
new SIZE- I ( If! R T P for real time programs 
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If the progran is assigned to a partition 
new SIZE-l < ASSIGNED PARTITION SIZE 



<The Minus one is because $lieGP a $MRTP does not include Base Page.) 

If the Size is found to be validthen the#of pages field is 
updated to reflect the new size. <Note that the ^of pages field 
doesnotincludebasepage.) 

NOTE also that fHRTP. $HBGP> or the partition size is not used if the 
(1»5tX address space is snaller than these values. That is^ a progrart 
plus the associated systew tables oay not e.xceed a 32K address space. 

EHftprograms have a special fom of the SZ connond <i.e.> SZ/PROG^Pl/ 

P2). As Mentioned earlier checks for partition and prog raw status 

are Made. Other checks are also «ade. The DE bit^ word I of the 

10 extension nust be set to change EMA size or the conwand is invalid. 

Recall that a set DE bit weans default EMA (not necessarily MSEC) was token 

In this case PI is the new EMA size and P2 is the new HSEG size. 
Plischeckedasi 

PI + PROG CODE SIZE < $HCHN or assigned partition size 

P2ischeckedoS'' 

P2 4 PROG CODE SIZE < PROG Address space 

If both of the above are satisfied Pl^ the new EMJ^ size is placed into 
the EMA size field of word 29 of the IDsegwent and P2is placed into 
the MSEC field of the 1st word of the ID extension. 

Thelast operator com wand that affects partitions is the UR conwand. 
This coflMQ nd clears the R bit in the referenced partition's tMATA 
table entry. This coRwand way affect the systen entry points 
IMCHH,. «MBGP and *MRTP. These entry points contain the size of the 
largest unreserved partition of that type (i.e. Mother/ bockground and 
r e a I t i H e .K 

If a partition is being unreserved and it would then be the largest 
unreserved portitionof its type then $HAXP will be called to do the 

appropriate updating. 



APPENDIX A 



Th« RTE IV ID Segnent Table 



The RTE IV ID segnent for disc resident programs is 33 words long 
addition, all E«A Type prograws have a three word ID extension 
Henor»^ resident prograns hove a 25 word ID segMent and progriM 
segments have a 9 word ID segnent. The fornat for the ID 
ID extension is shown on the next page. A description of 
various words, fields end bits follows. 



segnent 
the 



In 



and 



Word I is the linkage word for the program. Whenever the program 
is put into Q stafce (scheduled op suspend., etc.) the prograw is 
put into Q lini^ed list threaded through word I. This word is olso 
used to queue the progran up on EOT's for I/O processing. 

Words 2-6/ called XTEMP/ are used dynQwicallg in the ID seghent 
for operating systen information regarding the progroi . Initially 
at prograM schedule^ the scheduler places the schedule paraweters 
into this 5 word drea. For example, a R(J.PR0GX.l/2.. 3 w;uld cause 
words 2-6 in the ID segment to con tain I. 2^ 3.0 ond respectively. 
The scheduler also takes the od dress of Word 2 ond places this 
into word II of the ID segment/ the B-Register at suspension word. 
When the prog ran starts executing the systen library subroutine 
RHPAR can be called; it uses wordll to pick up the run poramet ers 
The words are also used for unbuffered I/O. 



Word 2 of the ID segment is also used to specify why a program is 
the general wait state. A programcan get into the general woit 
state in eight ways. The reason for being in a state is specified 
in ID seg«ent word 2 by the following rules'. 



t n 



REASON 



CONTENTS OF ID WORD 2 



Waiting for Resource # 
LU« locked 



allocoti on 



Resource # locked 

Waiting for class # allocation 

Waiting for Class Get Conpetition 

Device (LU or EQT) down 

Woiting for Son to complete 

Buffer L ! w i t e d 



for LU reference 
RN « 



Address of *RNTB 

Bits 6-10 of DRT 

= RN« 

fk<i6re5 5 of referenced 

l^ddress of $CLAS 

Address of *CLAS entry referenced 

4 

Son's ID address 

EQ T addr ess 



Word 2 is also used by the *ALC routine anytime a program needs 
wore system available memory than is currently dvailoble;. assuming 
that thot much mewory can ever be ovailable. In this case lALC 
places the number of words requested in Word 2 of the requesting 
programs ID segment. Every time memory is returned through *RTN, 
word 2 of the highest priority memory suspended program is checked 
see if the memory suspended program can be rescheduled. No lower 
priority memory suspended progroRS are suspended until the highest 
priority memorysuspended progron is rescheduled. 



to 



Word 7 <s the pr.orit.^ word. This has the priority of the progroN 
Prior. ties rong.? fron I to 32767 for user progroMs. Occasionally, 
s y s t e ft s p r o g r Ci M s give themselves a priority of , F H G R does this 
at Boot up. Th;5 allows the program to run at the hiqhest pnssibl^ 
priority. 



Word 8 is the prinary entry point of the prograH or progran se^nent 
It is the relocated address of the first instruction in" the 
to be e ){ e c u t e d . 



program 



Word 9 is the point of suspension. Gverytiwe a progran ts suspended or 

interrupted Word 9 is the address within the program to start the continuation 

of that progrQM when ft is rescheduled. Whenever a program 

terwinates this ward is set to zero. However., if the program terninatps 

saving resources (NOT SERIALLY REUSAeiE) word 9 is not reset because 

to terminate savingresources is to sove the point of suspension. 

Then whenever the progran is rescheduled., execution will begin it 

the d d r e s s specified in word 9 . 

This word does have one other use which is not generallM l^nown The 
word can also be used as a debug tool for the systems level prograwner 
Since the word always defines the point of suspension., it always 
defines the area of a prograw which is in an infinite loop. This is 
especially useful for the assembly language proqranner because the 
infinite loop location can be q u i c t; t y pinpointed. 

Words 10.U,12 contain the fl.B and E/0 registers at suspenc.inn 
Words 13.14 Qnd the up-p^r byte of word 15 contain the 5 rtSCII 
c ho roc tens of the progran name. 



The lower byte of word 15 contains the TM.CL.AH and SS bits plus 
the type field. Word 16 contains the Nrt . NP . « , rt . , f? ond D bits 
plus the status field. These bits and fields are used as follows! 



TH 



CL 



This 
no p 
the disc 



bit is set if the p r o g r a n is t e n p o r a r u That is. there 
no perfienont copy of the ID segment in the'systew area of 

p r g r a N is a permanent one 



If the bit is clear the 



HeNory locU (core lock", b.t This bit is set by the EXEC 22 request if 
the user w.shes to loct< the program into neworq and thus 
prevent swopping. 



Short segment bit. If set, then the 10 segnenf. is a 
ID segnent used for segments in a segmented progran. 
is set up by the generator and never changed. 



9 word 
This 



Type FIELD. This field of word 15 specifies the progrciw type 

Menoru Res = 1/ Real Tiwe = 2/ Back round ~ 3.- Large BacUround 
Segment = 5 (refer tosuwriciry of types in user nanual. 



H^ 



= 4 



Ho Qbort bit. This bit is set if the signbit of the current 

EXEC call is set. It informs the system that ce stain errors 

are in this request to behandled by the pro gran itself 

and should not cause the progran to be aborted. <,;pjRQ.. RE/PE^ 

ond DH errors will abort the prograw regordless). Mote 

that setting the sign bit of the EXEC request also increNents 

the nornal return address of the EXEC request by one. 



HP 



Ho paraneters allowed on reschedule. This bit is set if 
no paraneters should be passed to the prog ran on reschedule. 
This bit is set if the program is operator suspended or if 
father suspends a son. 

The wait (y) bit is set whenever a progran (father) has 
scheduled onother progran <son) with wait (EXEC 9 or 23). 
The son's ID address will be found in word 2 of the father's 
ID se gn en t , 

This is the obort bit. This bit is set when o progran is 
to be aborted. If the A bit is ever set on a LIST processor 
entry/ no natter what the request* the progran is innediately 
put dornant. The ft bit is set by the systew on detection of 
certainerrors. 

The operator suspend <0) bit. This bitis set x^^ew an 
operator suspension is attenpted at a tine when it is not 
feasible to do it directly. The bit indicates that the systen 
should do it at sowe later tine. This is what is weant by 
deferred action. The systen tried to do sonething.^ found 
outj for one reoson or another/ that it wasn't feasible so it 
wrote a note to itself (set a bit,>to rewind it to dothe 
requested action as soon os it is feasible. Unconpleted DISC 
I/O would be one reason for deferred oction. 



The sove resources <R) fait is set to indicate that the progron 
would like to save its resources when it goes dornont. The 
R bit/ for the nost part/ is also a deferred action bit in 
that it indicates how a prograw is tobe set dornantwhen It 
is set dorwant. (This bit has nothingto do with 
a serially reusable progran tern i nation.) When the prograw is 
set dornant the fait is cleared. Word 9 = is the flag by 
which the systen knows that the progron terwinated saving 
resources . 



The dormant <D) bit is a deferred action bit whirh is set 

.f a progran cannot be set dornant on request. It indicates 
thot the progran is to be set dornont as soon as feasible, 

^'''"' lll^l'l J'l'a'? .''' ?''''' ''''' '' *^^ program. States 

are 0.1,2.3,4,5.6 - dormant, scheduled, I/Q suspend, general 
WQ.t, nenory suspend, disc suspend, and I/O susppnd 
respectively. ♦'-« 

?he'^«roI;I^'^^^^' contain tine scheduling infornotion about 

♦ 5? llnfy , I'"'' ''''^'" "^' "'"^ '" ^^^ operotor co.nand 

*ST/PROGX to give tiwe infornatian about the prograM. 



in the tine 



yord 17 is the tine list linUage word. All prograws 
list Will be linked together through this word. 

Resolution (bits 15-13) in word 13 contains the resolution code 
pi.er (bits ll-O) contoin the Multiplier for the resolution The 
IS set if the prograw is in the tine list. Words 19 and 20 contain 
the systen time in lO's of Milliseconds of when the proqroM is to 
execute next. The two words give a 10 niUisecond resolution for a 
24 hour period. Word 20 contains the high order bits 



Mul t i 
T bit 



of the t iwe 



Uord 
'its 



21 of -the ID 



segment contains the BA , FW , «TH , AT > RM , RE . PW ond 
^ plus the father ID segnent nunber field 
f I I ows J 



They ore used as 



RN 



8A Batch bit. This bit is set if the progran is running 

under batch Pro-gran JOB or the FMGR ! JO connand set this 
bit. The batch bit is propagated fron father to son 
That is, if the father is under batch and schedules a son 
the son'sBAfaitwillbeset. 



FW Father waiting bit 
<£MEC 9 or 25) The 
scheduled W/0 wait 



If the fother, scheduled with woit 
son's FW bit is set. If the father 
the bit is c I ear . 



«TH «ulti Terminal Honnitor Bit. This bit is set if the program 
operating under the session node. Like the Brt bit, th 
propagated fron father to son. 



( s bit 



I s 
i S 



This bit is set 



AT Attention fait also colled the break bit 

by the BR opera tor conna nd and cleared by the IFBRK iuiten 
l.brary routine and progron terwination. 



RM Reentrant wenory pjoved bit. This bit is set If the progrctn 
Hqs information (Tenporory Data Block) in systen available 
Reriory that must be Moved into the prograii area before the 
p r o fj r a n can continue to execute 

RE Reentrant routine in control now. This bit is 5et onytine 
a reentrant subroutine of this prograN is executing, 

Py Pro gran wait bit. This bit is setwhen so we progrart wishes 
to schedule this progran with wait <EXEC 9 or 25) but this 
pro gran is currently active. The perspective fatherwill be 
in the general wait state with the prospective son's ID oddress 
in word 2 of the prospective fathers ID. 



RH This bit is set when a resource 
locked by this progran. 



number is either owned or 



Father FIELD. The field is used if this progran is a 

son. The field will have the ordinal number of the father's 
ID segnent. The nuwiber will be there regardless of the 
type of schedule i.e.. E>{EC 9/10/23 or 2 4. The least significant 
bit is alsoset if the progran terwi nates serially resuable. 
This bit is a flag for the dispotcher to avoid certain progran 
clean up procedures. The bit is cleared later. 



22 contains the RP bit, the # of pages field/ Memory protect 



Word 

fence index field., and the partition nuwber field 

RP Reserved partition bit. This bit is set if the progran is 
assigned to a partition. The partition number will be in 
the partition nunfaer field. The numbers startcounting from 

. 

# of PAGES FIELD. This field contains the number of pages the 

progran takes up not counting base page. For segmented progroms 
its is the # of pages of the main/Subroutines end lorgest 
segnent. FarEMft programs the size includes moin/sub routines, 
largest segnent and the MSEC si2e. 

FornonEMAPrograns 

1 ( # of pages < MftXIHUM L OG I C AL AODRE SS SPACE <in pages) 

For EMA PROGRAMS 

2 < # of PAGES < MAXIHUH LOGICAL ADDRESS SPACE + M3EG SIZE 



MPFI FIELD. Thisis the mefsory protect fence index field. This 

field contains on index CO -5) which when added to the start of the 
memory protect fence table gives a location containing the 
proper memory protect address for this program, This is 
set by the LOADR or generator and does not chanqe. 



Partition # field. This f ? e 1 cl contains the partition number that 
the prog ra PI Ust executed m. [Counts froN 0.] 



Words 23 and 24 contains the high na i n +1 and low nain address 
respectively of this progron. The high +1 address does not 
the high ri a i n +1 of and p r o g r a w segments. 



n c I u d e 



Words 25 and 
the prog raw. 

Word 2? conto 



6 contain the low and high base page address 
high +1 does not include I i n l^ address for 



of 



any program segment 



fns the disc address of the virgin copy of 
on the disc The progran nay on. ly reside on LU2 

if on LU.3 bit 15 is set 



IS Clear/ 



or L U 3 
Bits 14 



then bit 15 

the tracts # (0--255:i and bits 0-6 contain the s e c t or nu wbp r 

23 is forwatted as word 2? but is the swap address 



pool for the prograw 



i n 



the prograpi 
If on LU2 
"^ contain 
Word 
the t r a c !< 



Word 29 
pr ograw 
e>! tens j 
size of 
Size is 
be a n \ 
n i nu s t 

Word 3 
+ 1 addr 
pT og r a w 



.3 used only for EMA programs and is zero for non EMA 
s. Bits 15-10 contain the ordinal nu«ber of the 3 word ID 
on associoted with this progran. Bits 9-0 contain the EP\A 
this progran. The value here will be I if a default EHA 
taken and the program has not yet run. Else the ^yQlue will 
n . M u m of 2 to the m a x i w u n size of the largest partition 
he prcgraN size. 

is used only for segmented programs and is the High Main 
ess of the pro gran., subroutines., and largest segment. If the 
t s n t s e g m e n t e d i t i s . 



Words 31/ 3 2 and 33 Q^-e session non iter words 
ID EXTENSION 



Word I and 2 of the ID extension contains the I/O bit. D E bit/ 
the current HSEG field., the «S£G Size field, starting prog page 
MSEC field, and start page EMrt field. 

I/O This bit is set whenever the I1SEG is modified in order to 
do I/O which crosses an MSEC boundary. It indicates th^ 
current MSEC number is not valid. 

f>E This bit is set if the default EMfl size ,s taken the bit 
is not effected bq (13EG. 



MSEC This is the size in poges of the current wapping segment. It 
can be declaredby the user progrow or defaulted. For default 
MSEG= Maxittun Logical Address Space -CPROGRAH SIZE 

+LftRGEST SEGHENT 
+SUBRnUTIHES 1 

Current MSEC. Hunber of the currently napped MSEG. 

START PROG PAGE H3EG. This is the logical starting page of the 
wappingsegnent. 

START PAGE DHA. Physical starting page # of the EMA-i.e.. first 
Mapping segnent directly behind the progran. 



The last word of the ID extension is the swap address of the EHA 
area of the program. It is the nunber of tracks of EMA array swapped 
to the disc. The swap location oft he EMA array will begin on the 
first track following the swapped program. 



KEYWORD BLOCK 



Because ID segwen 
resident size 33/ 
indexing to the first 



S I Z B: 



vary C Memory resident size - 28. di^c 
progroM segnent size ^ ^ ) , sowe method of 
or the n a M e word of on ID 
necessary. The keyword block is used for th 



segwen ts is 
is purpose. 



LocQt.on 1657B on base page specifies the first entry ih the 
keyword faiock. The keyword block in turn contains l^.ord en 
each pointing to an ID segment, Last €ntry = <». Keyword Bloc 
are ordered ot generation by progran type; ^>e^»ory resident. 
I'!!l.!!"^ .!!^.r"'''^"*' ^^ckround disc resident, available 

segments 



tries.. 
Keyword Block entries 



ID 



segments/ and the program seqnent ID 

The keyword block entry (ID address.) + 12 always points to the 

noNe-word. Thus, keyword entries for short 10 ^""'^ ^° *^® 

the first word of the ID. 



s don't point to 



NOTE: Keyword +12 always points t 



n a M e 



ID EXTEHSIOH KEVMORD BLOCK 



Like the keyword block for ID segnents. the ID EXTENSIONS also have 
a table of pointers also terminated by a 0. Word $IDEX points to 
the ID extension keyword block. Each word in that block points to 
an ID EXTENSION. 



A P P E H D I ;>,' B 



DISPATCHER INTERFACE TO THE LI 



PROCESSOR 



As Mentioned earlier $LIST pushes progroms that tern i note into q 
stock through word 9 of the ID s e g n e n t heeded at $ Z Z 2 Z in the 
dispatcher. The dispatcher uses this s t a c I: to do p r o g r a n clean up. 
Ev«rytiwe the system has nothing else to do. it juNps to $XEQ in 
thedispatc her. Every tiwe the systew goes to $KEQ it first checks 
fZZZZ. If it is non-zero it does the following to clean up every 
program '• 



M^ 



First it sets the program's point of suspension •'ID word 3 ) to in 
cose the program is to be run later Next if the program is disc 
resident/ any swap tracks it way have are released. This nay happen 
if a prog ran that is swapped out is aborted. A father May also abort 
his son causing this condition. The tracks are released by $PREL 
in the EKEC. *DREL also nakes a call to $LIST in the scheduler to 
reschedule any prograMS that nay have been waiting for disc spoce. 

The dispatcher then calls $ fl B R E in EXEC to return any reentrant 

Ne«ory the prog ran nay have. This nay happen if a progran terninates 

or isaborted while in a reentrant subroutine. If the $ABRE routine 

returns any nenory via the $RTH subroutine in liftLC/ progroMs waiting for MsnsorM 

nayberescheduledbycallstothe list processor. 



Hexta call \ s made to-the *RTST routine in the scheduler. This 
routine returns any string n e p) o r y the progran nay own. If arm 
M e n r y is returned/ programs waiting for nenory nay be scheduled 
by a call to the list processor. The systen then calls i'WATR in i 
scheduler to schedule any programs thot nade SCHEDULE MITH QUEUE r 
< E X E C 2 3/24) for the progran. *' ^ A T R calls f S C 3 which calls HIST 
such p r g r a M s $ S C D 3 scans the general wait list < n q j o r s t a t e = 3 ) 
for entries which have word 2 of their ID segnent equal to the ID 
address of the terninating progran. Prograns in the general wait 
Will h a v« e word 2 of their ID s e q fi e r t set as follows; 



h e 

e Cj u e s t s 

f r a n y 
I U i n g 
segnent 
I i s t 



REASON 



CONTENTS OF I D < 2 ) 



yflIT TO SCHEDULE ft PROGRflri 
WrtIT FOR COMPLETION OF A "SON 
RN ftlLOCOJB Uf\lT 
RH LOCK WAIT 
L U LOCK WAIT 

DOyN DEVICE 

BUFFER LIMIT EXCEEDED 



The prograns ID segnent address 

The " .-J n s " ID segnent address 

Address of the R H table 

Address of the R H n u n b e r 

Address of the RH nunfaer associated 

with the L U L C K 

4 

Address of the E Q T on which the 

linitation was e.^iceeded 



NOTE t h Q t 
QUEUE . 



this call also handles the prog rows thot scheduled with 



After $MATR returns., the systef^ calls $TRRH which calls $ULLU to 
unlock any loci: L U ' 5 t he pr og ra m has. $ T R R N also unlocks any local 
f?N locks and deallocates: any local RN allocates the progran way 
have. Each of these processes nay call $SCD3 to p i cli -.p and schedule 
w a i t i n 9 p ?• o q r a M ;> . If there are any such programs * S C D 3 will 
:£ L I S f . 



ill I 



Lastly, if the progrow is a discresident prog raw and theprograw 
still owns the partition but did not Ma^ie a serial reusable 
termination, then that partition is released and made ovoilafale 

t o t h e r p r o g r a f t 5 . 



The followingpage is a quick sunMory of all 



this activity 



* L I S T CALLS USED IN D V R <iO , D V R •> 5 .. D V R 3 7 



DVROOond DVR05 both schedule the systew prog r on PR N PI with q $LIST 
c<ili if addition/ the B r eg i 5. tar it suspension (word 11) \s set 
to point to the E Q T word 4 f t f^ e E Q ^ of the i n t e r u p t i n g device. 
Both of these functions were s e p e r a t e b u t. m u w i \ ), b e c n d e n r ? d 
into one *LiST call. The calling sequence »s; 

J SB *L I ST 

OCT 601 

OCT ID ADR 

OCT B V A L 



I D A D D R E 3 S > 

THIS VALUE PLACED 



INTO ID WORD 4> 



The H P I B d r .' V e r will schedule q p r g r ct n on interrupt and pass 
three words into the tewporory area of thot programs ID ssgwent 
The *LIST calling sequenceto do thi.? is' 



J SB 


ILIST 


OCT 


\ 


DEF 


RTH 


DEF 


I D A D R 


DEF 


PI 


DEF 


P2 


DEF 


P3 



RTH 



It is up to the HPIB suh row tine library to correctly find ID aidr&ss 
of the progrow to be s.ched w le d nd pass this to the driver. 
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\ ^vcrviv?;w ct Operation 

Dyste;'i •]"ai:les Kelerenced 
System i^ase Page Communicator 
Lxternc.1 Subroutine Called 

3.0 Detailed Teclnrical Aspects of Operations 

3.1 Parity jrror Detect icr 

J. 2 Sarity Brror verification 

i.j Ic:rity Crrcr recovery Philosophy 

3 . 4 ;-.. G L t Pari ty Error 

3.3 ; vst^'j,- parity Error 

3.b ussr i-rotjram Parity hrror 

3.7 ! C L'C 1 a r i t y Error 



1.0 GENERAL OVEPVIE^\ OB^ CPEPZXTOW 

The Parity Error module's main task is to report 
parity errors detected by the hardware and to 
continue operation of the BTE-iv system if possible 
PEKR4 also tries to reproouce Darity errors ' to 
Identify and warn system users of soft parity errors 
errors which may be intermitten or may be qenerated 
erroneously. 
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2.0 LXTLi-^NAL CG.;^:[^u:UCA'i: IGK 

'ihe Farity Lrcor iriocule ccmrriur icates with the 
rest ct the CDeratinq systeift through the syster 
tables, bc'se paqc comrounicatior. area, and subroutine 
calls to other '■"oaules in the system. 

2.1 System 'raDler. T^eferenceo 

The .vystern taoles used by FERR4 are: 

a. ID Segment entry for accessing orogram 
status . 

b. $MA'iA table for accessing partition 
ccnf iqurat ion information. 

c. INI taDle for deterinininq PORT map status. 

2.2 Syste.Ti :.ase Page Comiriunicat ion 

Address of current r^iAF entry 
Address of interrupt taole 
Aodress of current lQT entry 
Aadress of current program ID 
Segment entry. 

2 . 3 E X te r n a 1 Subroutines Call ed 

s.^.LMi - set up ABE,XYO regiter repcrting messages 

and print them on systeix console 
!;Cl,V1 - convert number to Af^CII (one word) 
•>CiV'3 - convert nunjber to ASCII (three v/ords) 
$i:'ts(-'C - used by PFPP4 to print "FE" error n^essage 

and abort user prog ram 
^ 1 .'"vX I' - r ee s t a ol i s h ira x i mum size wo r d s of 

unreserved partitions 
i;:SYi'iG -- print roessace on svste;" ccnsole 
$UrMPL - unlink a partition entry froiri the proper 

list and unde fine the oartition. 

2.4 Otr.cr rxternal References 
'?LIC - entry point to Central Interrupt Control 

routine (contains address of last point of 

interrupt ) . 
$ r j t'-; S - t v/o word save area. 

word 1 - Di' uS status at last interrupt 

woro 2 - Interrupt status at last interrupt 
if OR, 1 if OFF. 
^=XC(., - c-ntry point of Lispatcher. This is used 

instead oi tl^e return point at $CIC when 

a oroqraiL is aborted. 



3.0 Dl'TAILED lECHNICAL AFFECTS OF OPEF^TIOKS 

This portion of the Technical Specifications is a detailed 
description of the major portions of the Parity Error module, 
PL;PK4. It is assumed the reader is familiar with 
the cetaileci operations of the Dispatcher (DISP4) and 
the 1/0 module (RTI04). 

3.1 Parity Frror Deteotion 

Because parity error interrupts can occur even 
when the interrupt system is off, the coce at 
?CIC must be able to save the complete system 
status. The major hole in being able to save 
the complete state is in saving the interrupt 
system state. In order to do this in both the 21MX 
and the 21XE the instruction 103300 was used to 
both test the interrupt system and turn it off. 

Parity error interrupts may be generated at 

almost anytime because DCPC transfers may be 

steeling memory access cycles. If it occurs while 

the system is in the idle loop, $CIC can't save 

the registers in XA, XB, etc. because all of these 

are actually one location. It was necessary for 

$CIC to identify the source of interrupt before saving 

all the registers. Only the A-register needs 

to be saved temporarily so that LI A 4 and a LIA 5 

can be done. PEPR4 is entered only when 

LIA 4=5 and LIA 5 = Ixxxxx. 

PERR4 saves all registers in local locations. 
It requires that 2 words be set up at entry point 
$DMS by $CIC. The first word being the DMS status 
register contents containing the memory protect status 
and mapping information. The second word indicates the 
status of the interrupt system at the last interrupt 
(the parity error interrupt) . The logical parity 
error address from the violation register is 
saved. The contents of location 5 are saved and 
replaceo oy a J SB indirect through a base page 
location to a PFi;PH4 routine. 



3.2 Parity Error Verification 

The routine TRYPE is called to test if the 
parity error is in the system map. '[The DMS 
status word cannot be used to determine the map 
under which the parity error occurred because 
certain DMS instructions change maps in the 
course of their execution and do not change the 
DMS status register.] TRYPE saves the map 
indicator value and then re-enables the parity 
error system. If the system map is needed, a 
regular load is done from the logical address 
of the parity error. The next instruction "s 
executed if there is no parity error at tested 
location. If the user map is needed, a cross-map 
load instruction is used to read from the logical 
address of the parity error. The next instruction 
is executed if no parity error is detected. CLF 5 
is used to turn off parity error until another 
verification attempt is made. A NOP is needed 
between the XLA LOGPE, I and the CLF 5 because of 
timing delays required by the 21MX/21XE. 

If a parity error cannot be reproduced in the 
system map an attempt is made in the port maps. 
The user map is saved before the Port Maps are 
checked. The interrupt table is checked to see 
DCPC channel 1 is busy. If it is, the Port A 
map registers are copied into the user map. The 
TRYPE routine is called to try and reproduce 
the parity error. If no error is found the 
next DCPC channel is tested in the same manner. 

After both DCPC channels have been tried without 
success, the user map registers are restored and 
TRYPE is called once again. The user map is tried last 
to avoid an erroneous report in the case where a swap 
out was taking place in one of the port maps. The 
user map may still contain a copy of the same user 
(left over from the set up for the port map by RT104) . 



3.3 rarity 1. rrcr Recover y ihiloscphy 

Khile it is possible to always detect the occurance 
of a parity error, it i? not alv;ays possible to 
effect a complete recovery from a parity error. 
There are a number of reasons why 100% recovery 
is net possible; these will be explained below. 
The overriding philosophy is to maintain system 
operation whenever possible and eliminate, if 
feasible, the possibility of future parity errors. 

1. Who dunnit? 

V/hen a parity error is detected, the violation 
register records the logical address of the word 
containing bad parity. The P-register saved in the 
interrupt handler's entry point may or may not 
point to the instruction which caused the bad 
iocation to be referenced. This is especially 
difficult to trace back when the instruction was 
a multiple word instruction such as XLA, MVW, or DLD. 
So while we may verify that a location in the system 
contains bad parity, we cannot determine that a user 
program caused the reference to the bad location 
via use of a XLA instruction. 

2. The sudden blow. 

A parity error detected during a DCPC transfer while 
the system map was enabled means the operating system 
was executing and it is a privileged system. Since 
the system may still be in RTIOC following a DCPC 
initiation, in the DISPATCHER in the EXEC abort routine, 
or in the system console driver; these routines 
would have to be reentered to print parity error 
messages or abort a program. So these are not 
recoverable. 

3. It's an inside job. 

A parity error detected within the operating system 
itself may cause errorenous execution of the 
system. For example, if a parity error was in a JMP 
instruction, it is possible the P-register may not 
get set correctly. This type of error is also 
not recoverable. 
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It a oarity error cannot be rGprocnceo (by reading a 
word at the loqical parity error address in the 
system inap, Tort A map, Port B map, and user 
map) then it is considered to be a soft parity 
error. This type of error usually indicates 
an equipment problem: There may be intermittent 
memory parity errors, it may be a memory coitroller/ 
oackplane problem, or even a firmware error. 

Soft parity errors cause a message to be printed 
which gives the loqical parity error address and 
the DMS status register contents at the time of the 
interrupt. These messages should help indicate 
where intermittent failures may be located, 
especiall;y if these soft parity error messages 
become mcjre frequently reported. 

System Parity Error 

Parity errors in memory locations in the system 
itself cannot be recovered as described in 
section 3.3. The system is halted (102005) with 
the A-reqister containing the physical page 
number and the B-register containing the loqical 
parity error address. The table areas and system 
COMMON areas are also considered to be part of 
the system. 



3.6 User Program Parity Error 

Parity errors within the memory resident area 
will cause the program to be aborted. The 
physical page number, ABEXYO register contents 
and the logical parity error addresses are printed 
on the system console in addition to the program 
abort message. The system then continues operating. 

Parity errors within a disc resident program 
require the partition or partitions affected to be 
undefined. The program's MATA (Memory Allocation 
Table) entry is examined to see if it is in a regular 
partition, a subpartition, or a mother partition. 

If the parity error is detected in a program in 

a regular partition or a subpartition, an attempt is made 

to check if the physical page number of the parity 

error is actually within the partition's 

physical page definition. If the page is not 

in the partition, the error is treated as, if it were 

in the system area and halts (102005). If the page is 

in fact part of the partition, the partition MATA 

entry address is saved. The partition is then 

unlinked from any partition lists and is undefined 

by a call to $UNPE. If there is a Mother 

partition, $UNPE is also called to undefine that 

that partition. 

If the parity error is in a program which occupies 

a Mother parti ton. The partition MATA entry 

address is saved. Then a search is made through all 

of its subpartitions to see which subpartition is also 

affected. That subpartition's MATA address is then 

saved and the subpartition is removed from the system 

by $UNPE. $UNPE also releases all the other subpartitions 

back into the appropriate regular partition free list. 

Finally the partition number or numbers are printed 
out as being downed. Then the program is aborted 
along with the parity error messages as in the case 
for memory resident programs. 



3.7 DCPC Parity Errors 

If a parity error is verified to have occurred 

under a DCPC transfer, the DMS status register 

IS checked (this is almost the only tiitie when 

DMS status register can reliably indicate the 

correct; map which was enabled at the time of the 

parity terror interrupt) . If the system was 

enabled at the time of the interrupt, a halt (103005) 

is necessary because the oprating system must 

not be reentered. If a user or the idle lop was 

interrupted, the I/O request currently queued on the 

EQT which had the DCPC channel is examined. If the 

request was a system or buffered request, a halt (102005) 

IS done. If it was a user request, the parity error 

is treated as in the case of a user program parity 

error as in section 3.6. 
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I. Suwnary of Systen Library Changes 

Chonges hod to be wade in severol systen library routines to nake 
then conpotible with RTE IV. The systen entry points n'-.essary 
i^ii- *rtLRN, RNRQ. LURQ. COR. ft. EQIU. IFBRK, PRTH and HESSS routines are 
included in Table Area I. The only changes «ade to these routines were 
to do crosswap loads and stores to entries in the systew. Routines KCVT/ 
THVAL.. IHPRS/ CHUMO/ CNUMD and PrtRSE need to use routines in the systeH 
whose entry points are not ovailoble to the user. The code for these 
routines <$CVTl/ $CVT3/ ITIHV and $PrtRS) is duplicoted in the 
systep) library routines that call then. 

Five new routines CORB. EHAP. I1HAP. .EMIO and EHrt were added to the 
systen library. COR.B routine returns in the B register/ the first word 
of free available newory of the program if there are no segments . If 
the prog rail is segnented then COR.B returns the high address + I of 
the largest segment. If the id segment address passed to COR.B is 
that of a short id segment/ COR.B wakes an error return with a -I in 
the A register. .EMAP resolves array addressing for norwal arrays 
and for EMA's. HHAP «aps Happing segnents for EMA'S/ .EHIO handles 
EHA addressing and napping for special cases to insure the entire 
buf'fer needed is wapped into the logical address spoce and EMA 
returns infornation on EMA. These new routines are described in 
thenext section. 

EHAP.. MHAP and .EHIO can be RP'ed in an RTE IV generation for use 
on a 21HX E-Series conputer with instructions which will link to 
nicrocoded versions of these routines. EHAP and .EHIO and HMAP are 
i nterrupt ibl e . The opcodes for the EHA Microcode are? 



EMAP 


105257 


EMIO 


105240 


MMAP 


105241 



2. Technical Detoils for EMARoutines 
2a. .EHAPJ 

This routine is used to resolve addressing of an elenent in an 
n-di«ensional arroy. The algorithw used to calculate displacenent 
for an or ray elewent (ft » A / A /...A > A ) is! 

1 2 3 n - I n 
D i sp lacewent = 

<<(...< (A -L )*d +<A -L ))*A +... 
n n n-l n-l n-I n~2 



■A -L ))*0 +(A -L ))*0 +<A -L ))* #words/ele«ent 
3 3 2 2 2 111 

where A , . . . > (\ are subscript values defining an elenent in an 

I n 
n~diHensional orroy^ L /.../L are the lower bounds of the dinensions/ 

I n 
D ..../D are the magnitudes of subscript declarotors (D»«Ui-Li+l/ where 

I n~I 
V is the upper bound of the ith dinension) 

i 

for dimensions I thru n-li S wor ds/e I enents is the nunber of words p^r 
elenent in the arroy (for e.g. 2 for real constants* 3 for double 
precision constant S/ett.). The leftnost dimension (A is the 

I 
subscript value) is varied the fastest to cole u late the displacenent. 

The user <co«piler in the cose of the higher level languages) «ust 
build a table containing the nunber of dimensions in the array/ the 
negative of the lower bounds for every dinension/ the nagnitude of subscript 
declarators for dimensions I thru n-l* and the number of words per elenent, 
and two offset words if the array is in EM A. The format of the toble isJ 



TABLE 



# d i mens i ons 

- L 

n 
D 
n-l 

- L 

n-l 
• D 
n-2 



- L 



~L 

1 
« 
off 
16 
off 
16 



f words/e lemen t 

set word Klow 

bits) 

set word 2<high 

bits) 



used only for EMA 



Where Li 



the lower bound and D* is the riagn 



tude of the ith dimension 



Th« calling sequence for .EHAP is: 



J3B EMAP 
OEF RTN 
OEF ARRAY 
DEF TABLE 
DEF A 

n 
DEF A 

n-l 



Return address 

start of the array 

Toble containing the arroy parameters 

Subscript volue for the nth diwension 

Subscript value for the <n-l)st dinension 



DEF A 



OEF A 



I 



subscrit value for the 2nd dinension 
subscript value for the 1st diMension 

RTN error return A Reg « 15 <Ascii), B Reg « EM (Ascii) 
RTN+l nornal return 6 Reg = address of the elenent 

If the XIDEX. base page locotion in the co«wun i ca t i on area 
contolning the currently executing progran's id segwent 
extension address is not zero and the start address of the orrau 
.s greater than or equolto the starting logical page of HSEG 
for th.s program, then the array for which addressing has to 
be -^esolved is an EMA-. the procedure followed by .EHftP to re^eolve 
elenent addresses for EMA and non-E«A arrays is the sane except for 
two-word calculations being perforned for the EHA Fo 1 1 ow i nq steD*: 
describe address evaluotlon for an elenent in EHA. " 

^' i^'ofl''^'^^ pointer PTABL to point to the first entry in 
TABLE and set the two suwnation words SUMl end SUW2 to 0. 

2 Get « of dimensions, if negative then error, if o then sU i p to Step 10 

3 Add -Li to Ai and odd it to the current sun of previous 
terMS<SU«l>. 

^ cMM^u ^^ ""^^^^ sunnation word <SUHl) is set, then increment 
SUM2 by I . Clear bit 15 in SUMl . 



Multiply sum by D 



Save A 3. B 



i-l 



registers in SUHl and SUM3 respectively. 

Shift bit 15 of SUMl into the bit position of SU«3 
ISofSUHl. 



Clear bit 



If SUH2 is not equol to multiply it by D 



i -I 



6 

I I 



Add 3UM3 to SU«2, 

All dimensions done? If not/ go to step 2 to eviluate displace- 
ment for thenext dimension. 

Get HSEGsize ond the logical stort page of EMA from the first and 
second words of the id segment extension of the program. 

Get the two offset words fr<3n the table. Adjust then so that the 
first word contains low 15 bits (bits 0-14) and the second word 
contains bits 15-31 of the double word offset. Error if second offse 
w o r d w a s negative. 

Add offset word I to SUHl and offset word 2 to SUM2 . Error if 
overflow occurs either into the sign bit or out of the sign bit of 
SUH2. 



13. The array is an EHA. To get the # of pages in the displacement 
move bits I0-I4of SUM I into the least significont bits of 
SUH2. Then SUI12 is the # of pages in the displocement. The 
renainder in SUfll is the offset into thelast page for the 
element address. 

14. Get EMA size from the id segment of the program. If « of pages in 
the displacement from start ofEHA+l >EMA size then error. 

15. Divide SUH2 by flSEG size. HSEG« = quotient. The number of words dis 
placement into the mapping segment = Remainder *200<» + SUMl. The 

8 
address of the element in the mapping segment = displacement + base 
address. 



Ito. The number of pages displacement from start of the EHA upto the start 
of the HSEG to be mapped JPGS=<numberof poges displacement from the 
start of the EHA upto the page containing the element -#of pages 
displacement from the start of the MSEC to be mopped upto the page 
containing the element). 

17. If the Mapping segment number in the idsegment e>! tension = 
f1SEG«and bit 15 of word of the id segment e.x tension is 
not set^ then go to step 24. 

18. To determine the highest possible HSEG«^ divide EM A 

size by MSEC size and if the remainder is equal to subtract 

I from the quotient. 

19. The highest possible MSEGt is HMSEG = quotient. 

20. If the renainder is not 0, the mapping segment size of HMSEG = 
renainder -l otherwise it is the standard MSEC size. 

21. If the Mapping segment to be mapped is HMSEG then its size is. that 
ofHM3EGandjumptostep23. 



2 3 . 



4 . 



22. The capping seginent to be Nopped is not the highest capping segment 
therefore the nunber of pages to be Mopped is equivalent to the 
standard napping segment size. 

Call HHrtP to Map the napping segnent with IPCS.. Napping 
segment size and napping segwent # as paraneters. 

Return with 6 register = the address of the elenent calculated 
instepl5atlocationRTN+l. 

2b. .EHIO 

This routine is used when the user wants to access a certain 
portion of the external nenory area and wants to insure that the 
entire portion will be Mapped in the napping segment EHIO 
chect«s if the requested length of buffer is contained within the 
current Mapping segHent or within any standard HSEG. If not. 
-EHIO Mops the pages that contain this buffer into the MSEC 
logicalMenory. 



The calling sequence for .EHIO routine is: 



JSB .EMIO 
DEF RTN 
DEF eUFL 
VEf TABLE 
DEF A 

n 
DEF A 

n- I 



Return address 

tofwordsinfchebuffer 

Table containing the array parQ«eters. 

subscript volue for the nth dimension 

subscript value for the <n-i:>st dinension 



DEF A 



DBF A 



I 



subscript value for the 2nd dimension 
subscript value for the 1st dimension 



RTH error return ft reg = i £, <Ascii). B reg = EH Cftscii) 
RTN+l nornal return B reg = address of the element 

Wheretheelementilocatedfii-Cfl a ^ ^i j.* 

louute-a a t: k» ,h /...,fl ,fl ) , r, t^^ array TABLE 

I 2 n-1 n 

.s the table containing array parameters as described in EMAP routine 

and BllFL .s the length of the buffer to be accessed. The leftnosr 

d.nension <A is the subscript value.) is varied the fastest to calculat 

t h e d i s p I a c e n e n t . 



. E M I r o u t i n e f I I w s t h e s e s t e p s ! 

Check IDEX location on base page. If contents ar- then not an EMA 
progroM/ return with error. 

Get the buffer length and set up the pointer to the table <j f array 

par J5rr et er s . 

Calculate elenent address following steps 1-16 described under .EHAP. 

rtdd buffer length and nunber of words displocenent fron start of MSEC 
upto the start of the bxiffer. Convert to poges. 

If this nunber of pages is greater than the standard napping segment 
Size, go to Step 7 to nap a non-standard Happing segnent for this 



the EMA upto 
of pages 
of pages Is greater tha 
s beyond the EHA, «ake an 
Otherwise the buffer fits Inside the standard Mapping 
follow steps 17-23 described in .EHAP to Nap this standard 

location with the 



Add the nunber of pages displacement fro« the start of 

start of the HSEG containing the element to the number 

calculated In Step 4. If this resultant nunber 

EMA size, then the buffer desired overflo 

err<ir- return 

s e g « e n t 

mapping segment. Hal<e a normal return to RTN-H 

address of the element in the B register. 

The buffer does not fit within a standard mapping segment, therefore 
a special mapping segment must be mopped to include the entire buffer. 

s calculated by converting the number 
..^ , o^thepagecontQlningthe element 

buffer length into pages. The number of pages offset 
pages from the start of EMA upto the poge conta 



The number of pages to be mapped 
of words between the start 



» n J ng 



and the 
will be the « of 
the el emen t . 



Set MSEC « 



M M A P Will 



to - I . 
na ke an 



Col I PIMAP to 



nop the non-standard napping segment 
error return if the number of pages askedto 
i.s greater than the standard MSEC size or it overflows the 



nap 



EHA 



Return to the calling 
the B register. 



program with the start address of the buffer 



I n 



2 C . « M A P 



This routine 

nap 

The calling sequence 



is used to nap a sequence of physical pages into the 
Mapping segment area within the logicol address space of the 



progr aM 



J SB HHAP 
DEF RTN 
DEF IPCS 



DEF NPGS 



RTH 



return address 

displacement in # of pages fron start 

of EMrt upto the start of the Rapping 

segwent to be napped, 

# of pages to be napped. 



Returns: Areg^Oifnornolreturn 

=-l if error return 

MMrtP routine hos three entrypoints." 

MMflP is the Main entry point into the routine. .MP is used by 
.EHIO routine to nap the n on- s t a ndar d nopping segnent, . MHAP is 
used by EMAP and .EMIO to nap the standard napping segment. 

MlifiP routine follows these steps: 

I. If IPCS and NPGS are negative values then error return. 

'^ ■ ^^ EMA is not defined in the calling pr ogran. error return is 

node. Get EWA size fro« word 2S of the id segment.- and 

HSEG Size fron the first word of the id segnent e.^Jtension of the 
pr ogr an . 



1 s 



3. Dtvide IPCS by the napping segnent size. If the remainder 
0. the poges to be nopped start at a standard MSEC boundary <:ir\cl thp 
quotient is the NSEG nunber to be napped. If the renainder is not' 
0. Q non-standard napping segment has to be mapped. 

4. If IPGS + HPGS is greater than EHA 5\2^ or the number of paqec: tn be 
napped <NPGS;» is greater than HSEG size, then 



an error return 



Next, HH^P adjusts the r)i.\v^ber of pages to be napped (HPGfi) to the 
standord MSEC size +1 (for the overflow page.). If IPGS + M3EG ^ize 
M is greater than EHA size, then NPGS is adjusted to EMA Mze-IPG 
fe., nusber of pages upto the end of Eflrt. 



th i s 



TJll.rV, P«i';^'^'^''^ '"' ''°'"'- ^'^ ''■^' physical start page 
nunber of EMU from the second word of the progran's 
extension. Add the IPCS 



id s e g n e n t 
to this value to get the physical start 
page nunber of themopping segment 



The user map residing in the upper 32 locations of the unmapped 
por.-on of the user base page has to be changed to point to the 
new mapping segment. The DMS base page fence is set such that 
these upper locations cannot be accessed wsith the normal user 
r.Qp setting. To wort-; around this.. MMAP reads DNS register 40 ,. 

which is the f.rst OMS reqister for the us.er nap and contains^ 



the user base page number 



The system entry point IDVPT contains the logical start page 

nuwber for the driver partition in the user «ap. MMAP changes 

the DMS register in the user nop corresponding to IDVPT to 
point to the user base page. 

The user nap in the up per 32 locations of the user base page 
can now be addressed through $DVPT. The logical address 
at which MHAP starts changing HSEG page nuwbers i s '• 

HL0C=$DVPT*2000 +1740 +start logical poge of HSEG. 

8 3 



10. The user nap is changed for HPGS starting at physical start 
page of the segnent to be napped. If NPGS is less than the 
HSEG size+li the rest of the pages 
write protected . 



in HSEG size+l are read- 



II. ^rdnsfer HSEG size+l locations starting at HLOC 

page of 



into the 
HSEG). 



DHS 



12. If HSEG nuBber is 



register starting ot <40 +logical start 

8 
-1/ set fait 15 of the first word of the id 
to indicate a non-standard napping segment, 
t 15 ond set up bits 5-14 of the first word 
extension to reflect the HSEG ift napped. 



segnent ex tens i on 
Otherwise clear b » 
of the id segwent 
f?e turn . 



2d 



E H ft S T 



This routine returns the total EHA size, HSEG size and the starting logical 
page # for HSEG. All of this information is picked up fron word 23 of the 
ID segment and words and I of the 10 segwent extension of the currently 
executingprograw. 

Th€i calling sequence is*. 



JSB EMrtST 

DEF RTH 

DEF HEMfi <refcurned) 

DEF NMSEG < returned) 

DEF IMSEG (returned) 



Return address 

Total EHA size 
Tota I nSEG s i ze 
Starting logical page 



HSEG 



RTH 



Upon return A register = if norwal return and -I if error return. 
An error return is nade if on EMA does not ex i st i.e./ XIDEX location 
on bose page conwunication orea is 0. 



2e Ricrocoded Routines 

The Major tine savings realized by m i croprogrann i ng the EMAP/ .EMIO 
and MM ftp routines derivesfrow two areas. The first is handling 
n<ip register Fiodifications fron the Microcode without the overhead 
of going priveleged in order to execute the appropriate DNS instruction 
This will eliminate approximately 300 Microseconds. The secnd area 
is com f^ on to both .EMAP and .EMIO and envoi ves the arithmetic 
calculationsnecessary to: deter nine element address. Every subscript 
past one will cause an additional iteration through this calculation 
loop adding an approxinate 40 microseconds software (10 nicroseconds 
Microexecution). The following table summarizes tining differences 
i'Q>" the softwore versus nicrocoded routines! 



Software 



F i r n w a r e 



?1HftP 

E«AP 
no remapping 



49 + 1.2 X (« pages."! 
39 + 10 X <» din."* 



. EHAP 

r enapp i ng 



88 + 10 X (i din) + 1.2 x <« pages) 



EMIO 
no remapping 



40 + 10 X <l di «) 



. EHIO 
re«Qpp i ng 



92 + 10 X (t din) ♦ 1.2 <# pages) 



fJll times are approxinate and worst case in Microseconds. 

The appro :^inGte Manufacturing cost based on using six IK PROM's 

i 3 5 $ . 



In o r d e 
H e H r y 
ft « ft o r y 
by spec 
■■■I i I a t i 

f<( f c r i n 
f'j e « o r y 
8 s pres 
r e - e n a b 
group r 
call t h 
the s o f 



r to Modify «aps fron the Microcode without DHS generating a 
protect violation/ the nicroprogranned nap routines disable 
protect and re-enable it upon cowpletion. This is acconpltshed 
ifying lOG in the special field creating a Mewory protect 
on. lAK is then specified in the special field of the next 
struction executed <occur5 at T6). The lAK is received by 
protect and it is disabled (assuwing a non-I/0 instruction 
ent in the instruction register IR). Mewory Protect is 
led by building a STC 5 in the IR and junping to the I/O 
outine in the base set. Because of this^ it is not possible to 
e firHware EHA routines fron privileged subroutines.- although 
tware versions can be called fro« a privileged subroutine. 



Th€ operati 
software wi 
<; Section 2q 
sonewha t d i 
quantity ra 
COUT i s u se 
possible be 
directly ra 
used by the 
result is a 

T h e 1 f> e r d 
N Q p chtt n g e 
one < r e g 41 
are referer\ 
contents of 
conpletes. 



on of the firnwctre is essentially the sane as the 
th Q few exceptions. Steps 4 through 6 of .EMrtP 
) which do double precision calculations ore 
fferent. The low order word is treated as a 16 bit 
ther than 15 bits as in the software. The flag 
d for carries into the high order word. This is 
cause the firnware does the required Multiply 
ther than calling the Multiply routine which is 
softwore Sign correction is not done, so the 
16 bit unsigned Multiply, which is what is required. 

ifference is in the woy base page is updated when a 
is required. The firnware uses user wap register 
B .^ to nap in the user base page. The nap reg contents 
ced With addressed 3740B to 3777B . The previous 
nap register 418 are restored before the firMware 



Two procedures are available to verify the proper instollotion 
operation of the firmware. A fourth opcode is provided which, 
executed in single step wode. loads 102077 i nto the S register 

The procedure torunthistestfollowsJ 



and 
when 



1 . Set P to 

2 . Load rt w i th I 05 24 2 
3. PushPreset 

4 . Push Single Step 

The display indicator should be S and the display register should be 
102077. Any other result is an error. The firnware siwply builds a 
1020 77, puts it on the display register, sets the display indicator 
to 3. and returns. It does test for single step so the instructions 
10 5242 is a HOP if executed while running. 



The second procedure is to run the t'Hfl verifier (nawes ilEHA) in RTE 
This does a cowplete test of all the operations of the fir pr ware. 



IV 



TECHNICAL SPECS FOR EMA MICROCODE 



Don VenhQus 



Project «1106 



Microcoded Routines 



The 
and 
t) a p 
of g 

This 

i 3 C 

past 
loop 
f'l ; c r 

f r 



Major t 

P\HAP r 

re g i s te 

i ng pr 

y i I I e 

M p^ n t 

u I a t i ri 

one w i 

adding 

e X e c u t 

the s f 



iMe savings realized by n i cr opr ogrciNN i ng the .ElirtP, .EMIO 
ou tines derives from two areas. The first is handling 
r modifications frow the microcode without the overhead 
iveleged in order to execute the appropriate DHS instruction 
liMinate approxi«ately 30 Microseconds. The second areo 
both .EMAP and .EMIO and envolves the arithrnijtic 
s necessary to deter wine element address. Every subscript 
II cause an additional iteration through this calculation 
on approxinate 40 Microseconds software <10 Hjcroseconds 
ion). The following table sufowarizes tin in g differences 
tware versus Microcoded routines! 



S o f t w r e 



F i r M w a r e 



NMAP 

. EHAP 

no remapping 

.EHAP 

r e n a p p • « g 

. E H I 

no r e ri a p p i n g 

. E M I 

r e R a p p i n g 



49 •«• I . 2 X < # pages ) 

35 + 10 X <# d i w .) 

(firmware .EHSP always remaps) 

4 3 + 1 X < » d i R .> 

^0 + 10 X <# diw.> + 1.2 <# pages) 



H I [ tines are approximate and worst cose in microseconds. 

The <s p p r X 5 N a t e Manufacturing cost based on using six IK P R N ' s 

. .- 5 $ , 

in order to wodify maps froN the Microcode without DHS generating a 
renory protect violation/ the microprogrammed map routines disoble 
newory protect and re-enable it upon completion. This is accofiplished 
t.ij specifying lOG in the special field creating a meisory protect 
V' i I a t i c n . I A K is then specified in the special field of the next 
ificroinst ruction executed < occurs at T6). The lAK is received by 
• ' <3 f) r M protect and it is disabled (assuming a n o n - I / instruction 

5 present in the instruction register IR>. Memory Protect is 
)• e-enabled by building a STC 5 in the IR and Jumping to the I/O 
' 3 1- u p routine in the base set. Because of this., it is not possible to 
r ii I I the firmware E M A routines from privileged s u b r o u t i n e s ^ although 
the software versions can be called from a privileged subroutine. 



It should be noted that the operation of the firMware version of 
EHAP is not identical to the software version. The calling sequence 
is the sane ond the result is the sane (that is* the address of the 
elenent is returned in B). However^ the firnwcre version of .EMflP 
does not use standard HSEGs. Instead^ it naps in only the p<^g€f 
containing the element and the following page/ if possible. 

Two procedures are available to verify the proper installation and 
operation of the firnware. A fourth opcode is provided which/ when 
executed in single step node/ loads 102077 into the S register. 

The procedure to run this test follows! 

I . Set P to 

2. Load A with 105242 

3 . Push Preset 

4. Push Single Step 

The display indicotor should be S and the display register should be 
102077. Any other result is an error. The firnwore sihply builds a 
102077/ puts it on the display register/ sets the display indicator 
to 8/ and returns. It does test for single step so the instructions 
105242 isaHOPifexecutedwhilerunning. 

The second procedure is to run the EMA verifier (naned #EMfl) in RTE-IV 
This does a conplete test of all the operations of the firmware. 

The opcodes for the EWA Microcode are? 



.EMAP 


105257 


.EHIO 


105240 


MMAP 


105241 



The fol lowing discussion assunes that the EHA Microcode at 
hand and that the KE w i cropro gr a mm i ng wanuol is available. 
i^ddr Bss references are to Micro control store addresses. 



SIC II an \ 



tMMl> 



2 2 0-2201? 

These are the 16 avGiloble entry points into this nodule. 

EHAP is the last one so that o juwp is not required. There 

no reason for the entry points not being sequential. 



i s 



220 17 



A read is storted to fetch the array oddress. P is incre- 
mented to point to the table pointer. The flag is cleared 
to indicated to MHAF <if it is called) 
froR a nicroroutine rather than with a 
that the return address is not fetched 
in the exit code. 



tha t is was colled 
105241 opcode. Note 
here . 1 1 » s fetched 



22020 



Since M has the address of the array address^ 
address of the return point. This is saved in 
returning and »n case of an interrupt. Y will 
location of the calling opcode +1. 



M-l is 
Y for 
hove the 



the 



22021-22034 

GETPARM is a subroutine which fetches a paraweter. The 

address is left in H. This section of code saves the 

orroy address and the table address. The address of the 

address of the ID extension <1645) is built ond put into 

33.^ which is never used for anything else. The contents 

of 164 5 is fetched and if zero* the non-EHf^ address calculations 

a r 6 u s e d . 

22035-22043 



yord I of the ID. EXT/ is fetched and masked to give the logical 
start of the MSEC If the start of the array is below the log 
start MSEC/ then it is not an EHrt array. 



1-2 



2 2 4 4 



The RESOLVE subroutine CQlculotes a 31-bit 
into EMfl froR the subscripts provided. 

22 45-22 51 



address offset 



This section of code SGves the address within the page 
and converts the 31 bit address returned by RESOLVE to 
physical page offset into EHA. If bits were shifted 
outthentherewasanerror. 



2 2 5 1-22061 

GETiflD2 8 fetches ward 28 of the ID segment. He:>{t we put 
1777B in L to do sone n asking, The LSB part of the 32 
bit address is wastjed to give the address within the page 
of the desired element. 84 (which was loo ded at 22040) is 
nasUed to give phys start page EHft. Finally, the EMfl 
size is put into L and subtracted fron the required offset. 
If the dnsk^er is positive then OFFSET) EMrtSIZE which is an 
error. If the result is -l;then the second page Must 
be protected. This is signaled by setting the flag. 

22062-22063 

Add the physical start EHA to the offset to giA^e the required 
ph ysicalpage. 

22064-22066 

F r n the logical start page of the MSEC in B . 

2206? 

C h p c U i ti t e r r u p t s b e f o r e w e c r a s h M P . 

22 70-22076 

The lOG here forces aHeMory Protect interrupt. The lAK four 
lines down ac knowledges the interrupt and thus disables MP. 
On the next line CIR is checked to see who received the IftK. 
It can only be I1P(SC5) or Po«erfQil<SC4). It is possible 
thot a powerfail occurred between the v^HP CHDX HOI and the 
lOG. If it did* we in mediately boil out. Sihce lOG happens 
at T2 and lAK happens at T6.. there is sone dead tiwe which 
can be used. First the logicol start page of the I1SEG 
is Masked out and saved in X. Then a 2004 OB is built in S2. 
This u i I 1 be u 3 e d r r setting the MEM address register. 



1-3 



22077 



Since an interrupt olwoys switches to the systew Nap 
nust be set back to the user 



MEM 



nap . 



2210 0-2210 7 



Since this revision of EHAP doesn't use standard MSEGs/ 
the nonstandard MSEC bit nust be set. The word is 
fetched and if that fait is not set, it is set <ind written 
back. 

221 10-22121 

How set the HEflf? to nap 40B which is the users base page 
Get the users physical base page and put it in the log start 
of MSEC nap register. Base page can then be updated by 
writing into location (log start address MSEC + 1740B + 
Log start Page MSEC). This was done so that it wasn't 
necessary to save a different nap register and restore 
i t when f i n i shed . 

22122-22131 

How write into SP the two physical pages which will be 
napped in. If the flag is set, the protect bits are set 
on the second page. 

22132-22140 



HEAR is set to the MAP at the logical start of MSEC. The 
physical pages required are in S9 and SIO. While loading 
the nap registers, there is sone dead tine due to the 
requirement for a READ. MRTE, or RJSO e>;actly two n i cro- 
instructions before a Q ,Q , or Q nicro order A STC5 

I 2 
Will be required/ so it is built now. 

22141-22147 



The address of the return address is in Y. This nust be 
retrieved to do a proper return. The address which «ust 
be returned in the B register is the address of the elenent 
in the page plus the logical start of the HSEG. The return 
address is increinented by one because the nornal return 
goes to rtn+l. The JMP lOG with STC5 in the 
register is required to turn MP back on 
turned off by the roC.IAK conbination 



instruction 
Since it was 



2315 0-22215 



I "4 



This section does the subscript calculation 
arrays. There is no nagic here. 



for non-EHA 



222 1 6"-22245 



Th 

t h 



op 

re 
f e 

e r 
< s 
pr 



is is the error return section. The error code is 
pendent upon which E fi A routine was called. H o w e v e r / 
sy an take the saite error exit. It is not possible 

just c h e c l-i the Counter (which is the low 3 bits of 
e IR) because it way have been used. The re fore/ the 
code i)ust be fetchedto determine the proper error 
turn. The error return exits by doing a .) uwp to 
t c h 'location ) rather than a return because the 
ror routine Hay have been Jumped to by a subroutine 
u c h as E M A S ) . rt R T M would return to the calling Micro 
9 r a (^i r a t h e r t f^ a n t e r w i n a t i n g the Microprogram. 



Section 2 



EHZO 



22246-22260 



The buffer length is fetched ond saved in S9. 
address of the return address is saved in Y. 
address of the toble is put in X. 1645B <the 
of the ID extension address) is built «n S3. 



The 
The 
address 



22261-2226? 



The oddress of the ID ext.. is fetch. If it is zero 
then error. Word I of the ID ext is retrieved via 
XLOAD ond nasked to give the log start addres«; of 
HSEG i n S . 



the 



22270 

EMflS Will do the required subscript colculations and 
conpute the HSEC required. 

22271-22301 



The address of the elenent in the page plus 
length gives the nunfaer of words which nust 
This is converted to poges and soved in Sll 



the buffer 
be napped. 



22302-22305 



If the nu«ber of pages for the buffer plus the offset is 
bigger than EHA size then error <buffer extends beuond 
end of EMA) . 



2-1 



22306-22322 



offset in the HSEG to the elewent. S2 + S9 con- 
pages gives the standard MSEC size required to 



SI i 3 t h e 

verted to 

hold the buffer. If this will fit in a standard 

we can isap a standard HSEG as calculated b'' EM AS 



SEG, then 



22323-22331 



CI u s t calculate the nonstandard H 3 E G n e c e s s o r y to 
burfer. SI is the logical address of the buffer 
nuT'iber of pages needed to hold the buffer, S6 



hold the 
S5 is the 
is set 



to the p c g e 
the elenent 
called f r n 
M H A P . B is 
e M it- t a 1^ e n . 



di sp I Cicener.t into EMA to the poge containing 

The flag is set to tell HMAP that it wos 
a Micro routine. f1MftP02 is an entry point in 
set to the address of the Buffer and a norwal 



2 2 3 3 2 



Cone here i f t h e buffer 



W 1 



II fit in a standard MSEC 



will w a p the proper « S E G if required. 
22333-22342 

This section of code gets the return address and sets 
rtn+l It a4so checks to see if a STC5 is in the IR. 
If not, then a normal return Is done. If there is a 
STC5 in the IR/ then Mapping occurred and 
t h r u q h the base set to turn HP back on. 



EMrtT 



P to 



we Must return 



Section 3 



MllrtP 



22343-22350 



The flag is cleared so that the napjp'i nq routine 
return to a calling routine but will exit. Th? 
displacewent is fetched. During the dead tine 1645 
built in S3 . 



Will 

page 



not 



i s 



22 35 1-2236 1 



Fetch the nuwber of pages and put Into S5. 
extension address and put into SP. 



Get the ID 



2 2362-22402 

The nunber of pages in a standard HSEG is retrieved from 
ID. EXT. word zero ond saved in P. The logical start of 
the MSEC is fetched fron word I of ID.eXT. and put in S9 
The physical start of E«A is put in S. The dispUcenent 
is added to phys. start page to give phys start 
of HSEG in S7. The displacenent is divided by MSEC size 
to see if a stondord MSEC is being Mapped (which »s true 
the renainder is zero) and to get the MSEC number. 

22403-22407 



The MSEC nunber (or all I's if a nonstondard MSEC is being 
napped.) is put in S4. Subtract the nunber of pages to 
be napped fron the MSEC size. If the result is negative 
thenerror. 



3- i 



22410-22426 



Get 1 1> e E M A size o n d put in L . fJ| d d the Start p o g e of E M ft 
and 3 !i w e in B This gives the lost physical page which can 
be Dapped, Next/ the p h y s s t (i r t page of t h r MSEC is 
added to the requested nunber of pages to give the lost 
pitqe requested If < 5P H SE G + R t Q S I Z E > >< SP£M« + Eh ASZ ) / the 
request was for tao w any pages. If <SPMSEG + STAN.IiSEG.SIZE)> 
<3PEHA + £MihjSI2E)/ then nap only up to end of EMA* otherwise 
fiop a St, andord fISEG nunber of pages. 



In other words 

cones first. 



Nap tothe end of EHA or the HSEG/ whichever 



22427- 2243 C 



The nap routines w i 
p a g e s / : f possible. 
; s With E M A . Kit 
checl-! for a pending 



II always nap the HSEG size +1 n u r b e r of 

This section checks to see if that lost page 
is not then it r»ust be protected. Then a 
halt or interrupt s done. 



22437-22442 



Meftory protect isdisabled by forcing and QcUnowledging a MP 
interrupt. This is necessary in order to load base poge and 
the DMS registers. The Central Interrupt Register is checked 
to see if th^e powerfail fail interrupt received the lAK. 
This is possible if a powerfail happened after the lost interrupt 
checl? . Return to the base set if powerfail was pending. 



3-2 



The interrupt forced q switch to the systew nap. DMS «ust 
be set back to the user nap. 

22444-22456 

The constanit200 4 06 will be used to set the Henory Expansion 
Address Register to the users physical base page. The 
page nunber is stored inS6. The content of user nap 
register I is saved so that the base page can be accessed 
through nop reg. I. Mop reg. I is then set to the users 
physical base page. Because of the requirenent for a READ/ 
R^I30 or WRTE exactly two instructions before sone of the 
OMS instructions/ there is so«e dead tiwe. This is used to 
build sone of the constants which willbe required later, 

22457-22463 



logical start page of the MSEC 



The 

the first of the nap register to be changed 
with STANSIZE+l because we olways load that 
registers/ although sone nay be protected. 



is computed to deternine 
83 i s I oaded 
nany nap 



22465-22471 



The location 374 OB is the start of the user naps in B? 

(renenber the physical base page was loaded intouser map 

reg. I). The logical start page of MSEC is added to 374 OB 

to give the place to start changing the nap registers. 

This address is soved in S6. Thecounter is loaded with 

the nunber of napsto be done. L is cleared so no read/write 

protectbitsareset. 



3-3 



2 4 7 2-2 



3 



This h e r I 
into base 
the nuf^ber 
protected . 



c loop writes the required nap 
page. The counter (previously S5> starts w 
of nap register to be loaded b<t not read/write 
The rest of the r eg i st er s / up to MSEGSIZE+l. 



register contents 
th 



are re<id write protected 

protected . 



If cntr=MSEGSIZE+ I no pages are 



2 2 !J <i 4 •■ 2 2 5 14 

This section reads the wop req contents fron base page 
and locids the D«S registers. The counter Must be decremented 
in theloop because ICNT followed Inwediately by JMP CNDX CHT 
does not always work. Hot© that the bottow 8 bits of the 
address is the negative of the nunber of tines through the 
loop. In other words, if the counter counted up we stop 
when it gets to 000 <the last wap to be looded is 1777 in 
ePi. Since the counter nust count down, we use the negative 
of the bo t ton 8 bits of the address . 

22515-22531 



Restore user wop 
and cross store. 

22532 



reg 
In 



I. Forn ID EXT word <f'tSEG« etc.) 
the Meantime/ build a STC 5 in the IR 



If the flag was set/ then we were called by a Micro- 
routine and Rust return. Otherwise return throuqh lOG to 
t u r n n H P . 



e c t I on 4 



EHA3 



22540 

Resolve computes o 31 bit address fro« the array subscripts. 

22541-22561 

The standard MSEC size is fetched and put in S5. The log stort of 
the MSEC is saved in 39. The required page is conputed 
and saved in S2 and A. If the pogedisplacewent is greater 
thonEMAsizethenerror. 

22562-22575 

The offset to the elenent is divided by MSEC size to 

give MSEG nunber. MSEC nuMber is saved in 34. The 

renainder issubtrccted fron the page offset to element to 

give poge offset to MSEG. The renainder is converted to words and/ 

added to the botton 10 bits of the 31 bit oddress to give 

the word offset in the MSEG. 6 is set to log start MSEG. 

(Hotes B+Sl gives address of elenent.) 

Resolve 

22576-22660 

This routine converts the array subscripts to a 3 1 bit address. 



EMAT 

C hecU to see if wopping is necessary. 

22661-2266? 

The logical address of the element if forwed in SI. 
Bit 15 of the ID EXT word zero is checi^ed to see if 
nonstandard KSEG is napped. If bit 15 is set, then 
r enap . 

22670-22674 



a 
nust 



The HSEG nunber in ID EXT word is cowpored to the required 
MSEC nuwber. If equal/ then don't have to renap. 

2 2 6 7 5-22723 



The Phys Start EKfl is fetched. Phys start EMA + offset to 

MSEC gives Start Page HSEG. Next, the Ed A size is divided 

by HSEG to give mox MSEC nunfaer. If this is the HSEG 

required we use the remainder as MSEGSIZE. otherwise 

use the standard HSEGSIZE. An entry into HMAP Is used 

to do the Napping. <Wote the flog is set so HMAP returns.) 



GETPARM 
22724 

Start a read in cose this address is indirect. Get the 
results and load H . 

22725-22730 

If the last address was not indirect; return with a read 
on the paraweter initioted. If it was indirect^ fetch 
its contents and try again. If halt or int. is pending/ 

go service it. unless it is single stepped. 

22731-22732 

The address of the EHA opcode+l u&s soved in Y. P is 
reset to this value and the interrupt handled. The £KA 
nicrocodewillberestorted. 

22733-22742 

This code used when interrupts ore checked at various 
places. 

POSOIV 

22743-22747 



Does a positive divide of A by L 
renalnder inB. 

GETAD2S 

22750-22754 

Get word 28 of the ID segnent 



Quotient in A/ 



Flows into XLOAD 



>; L ^ D 



22755 "22761 

Does a cross load. Can't return on the sane line as 
TAB b <=" c c? u 5 e word Type II m a u not work r i ci h t ai'ter T ft B . 
H u s t h !i \i e 3 11 in S - b u s field so we can do conditional 
j u w p s D Q s e D OH retrieve d v q I u e . 

22762-22763 

I " p v.» e r f G u I occurred before the I A K then c o m e here. 
reset P go t base se t a f t er I AK . 

227 6 4-22771 



This sec tionof code builds a 10 20 77 in the S register 
This can be executed from the front p<inel to verify 
proper i nst a 1 1 q t i on o f t he ROHs . 
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1.0 INTRODUCTION 

This section is intended to serve as an aid to the programmer when 
modifying the online generator program RT4GN . It should be used in 
conjunction with the generator source listings, as it in no way attempts 
familiar with RTL-IV and its generation process, and has run 
the generator. It assumes familiarity with the RTE-IV online 
generator reference manual outlining the generation process. 

1.1 General Overview 

The modularity of the RTE software makes it easy to configure a 
real-time operating system tailored to particular application 
requirements for input/output peripherals, instrumentation, 
program development, and user software. With the online generator 
a configuration can be achieved under control of the present RTE 
system, concurrent with other system activities. The online 
generation process utilizes the file management features of BSM 
for the retrieval of the generation parameters and software 
modules, for the output of the system bootstrap loader and for 
the actual storage of the absolute system code and its 
associated generation map. The special utility program SWTCH 
performs the switchover from the present system configuration 
to that of the new. 

1.2 Operation 

RT4GN is a type 2 or 3 segmented program requiring Table Area II access in 

RTE-IV. The generator accbpts its command input from an "answer" file locateo 

on disc, a logical unit, or a combination of the two. These parameters direct 

the generator in building and defining the system tables and values, 

the logical memory layout, the physical memory layout, and in relocating 

the software modules to be included in the system. All relocatable 

modules must exist in FM^ file format and are specified by file 

name to be included in the system. The absolute, memory-image system 

being built is itself stored in a type 1 FMP file, which is then 

transferred by SWTCH. 



2.0 GENERATION SEQUENCE 



LIST FILE NAME? 



ECHO? 



EST # OF TRACKS IN OUTPUT FILE? 



OUTPUT FILE NAME? 



SYSTEM DISC? 
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for HP 7900/7901 Disc Only: 
CONTROLLER SELECT CODE? 



#TRKS, FIRST TRK ON SUBCHNL? 
0? 



or for HP 7905/7920 Disc Only 
CONTROLLER SELECT CODE? 



#TRKS, FIRST CYL #,HEAD,# SURFACES , UNIT, # SPARES FOR SUBCHNL 
00? 



SYSTEM SUBCHNL? 
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AUX Disc? 



^]0 



YES 



AUX Disc SUBCi .K'L? 



# TRACKS 



V 

# 128 Vv'0i-1D SECTORS/TRACf^ 



/ 

TBG CHNL? 



TBC SELECT CODE? 



PRIV. INT. SELECT CODE? 



MEM. RES. ACCESS TABLE AREA II? 



RT MEMORY LOCK? 



BG MEMORY LOCK? 



SWAP DELAY? 



MEM SIZE? 



BOOT FILE NAME? 
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PROG INPUT PHASE 



7e 

PARAMETERS 



7e 

CHANGE ENTS? 



/E 



Table Area I 
Equipment Table Entry 
EQT 01? 
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EQT 


02? 


EQT 


03? 


EQT 


04? 


EQT 


05? 



/E 

Device Reference Table 

1 = EQT #? 



2 


s 


EQT 


#? 


3 


= 


EQT 
f 


#? 


4 


= 


EQT 


#? 



/E 
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Interrupt Table 



ENT 



$POWR 



/E 

TABLE AREA I MODULES 

I load map 

DRIVR PART 00002 
CHANGE DRIVR PART? 

DPOl: 

I load map 
SUBSYSTEM GLOBAL AREA 

I load map 

RT COMMON XX XXX 
CHANGE RT COMMON? 



RT COM ADD YYYYY 
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BG COMMON XXXXX 
CHANGE BG COMMON? 
BG COM ADD YYYYY 



BG COMMON XXXXX 
SYSTEM DRIVER AREA 
I load map 

TABLE AREA II 

# OF I/O CLASSES? 



» OF LU MAPPINGS? 



fr OF RESOURCE NUMBERS? 



BUFFER LIMITS (LOW, HIGH)? 



1^ OF BLANK ID SEGMENTS? 



j^ OF BLANK SHORT ID SEGMENTS? 



I OF BLANK ID EXTENSIONS? 



MAXIMUM # OF PARTITIONS? 



TABLE AREA II MODULES 
I load map 

SYSTEM 

load map 
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PARTITION DRIVERS 



DP 02: 



DP 03: 



load maps 



MEMORY RESIDENT LIBRARY 
load map 

MEMORY RESIDENTS 
I load map 

RT DISK RESIDENTS 
load map 

EG DISK RESIDENTS 
load map 



RT PARTITION REQMTS 
PNAME XX PAGES E 



BG PARTITION KEQMTS 
PNAME XX PAGES *E 
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MAXIMUM PROGPAM SIZE: 
W/0 COM YY PAGES 
W/ COM ZZ PAGES 
W/ TA2 XX PAGES 

SYS AV MEM XXXXX WORDS 

1ST PART PG YYYYY 
CHANGE 1ST PART PG? 



SYS AV MEM XXXXX WORDS 

PAGES REMAINING: XXXXX 

DEFINE PARTITIONS 
PART 01? 

• 

SUBPARTITIONS? 

/E 

MODIFY PROGRAM PAGE REQUIREMENTS? 



/E 

ASSIGN PROGRAM PARTITIONS? 



/E 

SYSTEM STORED ON DISC 

SYS SIZE: XX TRKS, YYY SECS 

RT4GN FINISHED 

ZZZZ ERRORS 
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3.0 FILE INTERFACE 

All I/O within the generator is handled through FMP calls, be it to 
answer, list, boot, echo, relocatable, absolute, or scratch files. Where 
I/O to a specific lu is allowed (answer file, list file, boot file, or 
echo) a dummy type file DCB is created so that the same READF, 
WRITF, and CLOSE calls are used throughout. Six DCB 's are set up 
and used (and sometimes reused) for file I/O: 

\ADCB Absolute output file - always open to a file 

\LDCB List file - always open to a file or lu 

\IDCB Input file - always open to a file or lu (changes as TR's and 
errors occur) 

\EDCB Echo - always open to lu of operator console but not necessarily 
used if \IDCB or \LDCB are used to same lu, or if option denied. 

\RDCB Relocatable input file - used to reference all relocatable 
files during generation, open to only one file at a time 

\BDCB Boot file - created only when boot file is output by PTBOT 
routine. 

\NDCB Modified NAM records file (@@NM(aA) - scratch file open 
when being built and when referenced during relocation 

All files except the answer file(s) and relocatable input files 

are created by the generator. The above two file categories cannot be 

actual type files, as the generator may reference them by 

record number. In the case of the relocatable files, the generator 

actually opens and closes each file many times. 

3.1 Interface Routines 

\CRET - is passed a DCB address and creates a file whose name is at 
PARS2+l,+2,+3, security code is at PARS3+1, and crn is at 
PARS4+1. 



\CRET first calls FOPEN which calls TYPO - if a type dummy DCB 
was built then that is sufficient and /CRET returns. If it was a 
file, then that file is closed (no error check done here 
on file since may never have existed), and then created by 
a CREAT call. 



A CPEAT call is made with the assumption that whoever called 
\CRET checks the FMP error parameter FMRR. 



\CLOS - i,^ passed the 



DCB 



acidress and truncate option. For a 
file, a simple CLOSE call is made, leaving the \CLOS 
caller the responsibility of checking \FMRR (not usual 
done) . 



ly 



\OPEM - 



TYPO - 



For a dummy type file, however, word 9 is merely set to 
0. If the type file being closed is the list file, then a 
page-eject control request is made to it. The no-abort bit 
IS set on the control request to prevent abortion ol the 
generator to a device with no EOF code (like the console). 



IE passed a DCB address, and attempts to open a file whose name 
IS m PARS2+l,+2,+3, security code in PARS3+1, and crn in 
PARS4+1. 

A call to TYPO determines if a lu was specified in the first 
parameter and TYPO sets up the dummy DCB \FMRR is always cleared). 

For a file, an OPEN call is made leaving the check of FMRR 
up to the caller of \OPEN. 

is passed the DCB address in the A-reg. It determines whether 
a numeric parameter was specified as a file name, in which 
case It will continue with the building of a dummy DCB. LU's 
are allowed by the generator for answer, list and boot files- 
echo IS always to the lu of the operator console (ERRLU) . 

The dummy DCB format and initial values are: 

Word directory entry address 

Word 10 of file 

Word 2 type 

Word 3 read/write subfunction, lu 

Word 4 EOF control subfunction, lu 

Word 5 no spacing legal 

Word 6 100001 read/write legal 

Word 7 100001 security codes agree; update open 

Word 8 JT ir 

Word 9 ID segment address of generator (from 1717) 

Word 10 

Word 11 

Word 12 

Word 13 (initial value) in buffer and write flag 

v^ord 14 1 (initial value) record count 
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Special checks are made in deterniining the EOF control of subf unctions. 
For driver types >=17 and for DVR05 exclusive of subchannel 0, a 0100 
IS merged with the lu. For DVROO, DVR02, DVR05, and DVR07 (subchannel 
only), the EOF control subfunction 1000 is merged with the lu. For 
all other driver types between 1 and 16, 1100 is the merged subfunction. 
For non-type 05 or 23 devices, an EOF will be sent immediately - 
causing leader or a page eject, respectively. 

3.2 Scratch File 

The generator creates a temporary file of its own for storage of 
modified NAM records, §@NM@A. Modified NAM records result when the 
program length of a compiled program has been determined (during 
the Program Input Phase), or when a program's priority or execution 
interval are changed during the Parameter Phase. If such a modified 
NAM record does exist for a program, then bit 14 of IDS in its IDENT 
entry is set so that the correct values may be retrieved during 
relocation . 

The generator purges this scratch file during final clean-up or its 
own abortion clean-up. The file will still remain, however, if the 
generation is aborted by some other means. When the generator tries 
to create the scratch file during initialization and finds that it 
already exists, it will increment the last character of the name (eg, A-B) 
and create a new one. It gets confused if there exist old entries in 
a file left over from a previous generation. 

3.3 Relocatable Input 

All relocatable input is handled through the routines \RNAM and 
\RBIN (both in the main). \RNAM sets up the parse buffer to open 
the file specified in the current IDENT entry (words \ID9 through 
\ID13). A non-zero B-reg on entry to \RNAM lets us assume that 
the file is still open. Otherwise, the relocatable file currently 
open to \RDCB is closed. \RBIN is called to (possibly) open the 
file, and to read the record specified by \ID14 through \ID16. \RBIN 
may also be called to merely read the next relocatable record of 
a file, and optionally to get its position. 



3.4 Answer File 

Upon start-up, the generator determines thru RMPAR and GETST calls whether 

an answer file name or lu was specified via the turn-on parameters. 

if the first parameter was 0, lu 1 will become the default 

command (answer) lu. If parameter 1 was numeric, that lu will be 

used for command input (in an MTM environment, this would be the 

operator console's lu provided no parameters were specified). A 

dummy DCB will be created in TYPO for the lu, or the answer 

file specified in the Namr parameters will be opened via FM^^. If 

an error occurs on the answer file open call, the appropriate error message 

will be displayed on the console via an EXEC call, and centre I will be 

transferred to lu 1. 

An "error lu" is also defined at start-up. If an lu was obtained 
from either the turn-on parameter or the default command lu 1, then 
that lu becomes the error lu provided it represented an interactive 
device. If it was not interactive, the photoreader for example, 
then the error lu would default to lu 1. 

When an error occurs, the error message (s) is sent to both the 
list file and the error lu. For many errors, control will be 
transferred to the error lu for corrective action by the operator. 
This is done by stuffing a "TR,ERRLU" into the command buffer, 
where ERRLU represents the two digit error lu. The error 
processor \GNER then calls TRCHK which processes the TR command. 
If the command input was already from an interactive lu then the 
control i^i^ not transferred from it. 

All command input is handled by the \PRMT routine, which also 
issues the prompting message. \PRMT filters the input 
looking for a !! starting in Column 1 - indicating the operator 
wishes to abort the generator; or for a , : or TR - indicating 
that a transfer is to be done. An EOF encountered in an answer 
file/lu results in the simulation of a "TR" command which pops 
the input stack. 

The parse routine \PARS is called with the input buffer address, 
and returns the parameters in the following format. Parameter 2 is 
the file name or lu, Parameter3 the security code, and Parameter4 
the CRN; 



PARS2, 


PARS 3, 


PARS4 


Type: 


0=null, 


l=numeric. 


2=ASCII 


PARS2+1 


PARS 3+1 


PARS4+1 







number 


ch 1 & 2 


PARS2+2 


PARS3+2 


PARS4+2 










ch 3 & 4 


PARS2+3 


PARS3+3 


PARS4+3 










ch 5 & 6 
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AsteriEks (*) are not allowed within filenames, security codes or 
cartridge labels. As soon as an * is encountered the beginning 
ot a ccmment is assumed and \PARS returns. 

\PPMT does some checks to determine whether or not to send the 
response just received to the list file. If the list file is to 
the lu of the operator console and if that's the current command 
^"?"^,^" (^'^^^^^ ^^^'^ the response is not sent; otherwise \LOUT is 
called \LOUT does more checks for echoing). 

TfsCHK determines if the command input stack is to be pushed or 
popped. If the current command buffer contains a TR (or : or,) 
with no parameter, then the stack is popped to the previous source 
of command input; otherwise the stack is pushed with the new element 
Ten entries may be placed on the stack by the user. (GEN ERF 19 on 
overflow or underflow) with each entry of the form: 

Word entry type: l=Type 0(lu), 2=file 

Word 1 lu, else CHI and CH2 

Word 2 C, else CH3 & CH4 

Word 3 0, else CHS & CH6 

Word 4 Security Code 

Word 5 Crn 

Word 6 0,else record count for next record to read 

An eleventh entry to lu 1 is hard-coded at the bottom of the stack. 

On a transfer, the current file is first closed. The routine PUSH 
will then save the next record number of that file in its stack 
entry, for repositioning when the file is later reopened. PUSH then 
picks up the file name/lu from the parse buffer and builds the new 
?^^n.r.^nSy^%.J^ Overflow results, no push is done (recovery handled 
in IKCHK). POP on the other hand merely decrements the STACK pointers 
to the previous entry - on underflow no pop is done and TRCHK handles 
the recovery. Before returning to TRCHK, both PUSH and POP call the 
routine STATE which performs status checks on the new source of 
command input setting CMDLU (0, else input lu) and lACOM (1 if an 
interactive lu, if a file name or non-interactive lu) . lACOM is 
used m determining the echo of input/output to the list file or 
console. STATE also checks the validity of an lu specified as the new 
command input source. If invalid, STATE does an error return, as does 
PUSH, and TRCHK issues a GEN ERR 20 and handles the recovery. This 
error won t occur on a POP as the command input source we're 
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returning to would have already been checked at the criqinal 
transfer. 

3.5 




CMER 



\SPAC 



DISPT 




\CFIL 



interactive 
input lu 



(if enabled) 



Figure 1 - 



3.6 List File 



Tree structure for generator 
echo/list output routines. 



command input and 



The operator chooses where they wish to send the generation listed 
output. If a file name was specified, then a file of size 
64 blocks IS created by the generator (extents are created as 
needed by FMP) . since a GREAT assumes an exclusive open, the 
file IS then re-OPENED with the non-exclusive option. This permits 
examination of the list file concurrent with generation. 

For list output to an lu. 
If the lu specified is to 

Driatf^jL^^fS'^: .^f "^^"ccessfui; the'g'enerator issues"thrappro- 

cai? wi?h fh! ^ ?^'';! ^^! ^""'"^ ""^ ^" ^^"^^) ^^^ reissues the lu lock 
call with the wait bit set. The generator is suspended until that 
time when the resource becomes available. 



a dummy DCB is created in the routine TYPO, 
a non-interactive device, then an attempt 
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If the lu was interactive then the flag lALST is set to 1. lALST 
and lACOM are then used in the list output routines \MESS and 
\LOUT to prevent duplicate output to the operator console. A line 
IS always sent to the list file (using \LDCB) via \LOUT. If the 
list file was not an interactive lu (IALST=0) but the command 
input/answer file was (IAC0M=1), then the line is sent to the 
operator console (using \IDCB) as well. The status of the command 
input mode reflected in lACOM changes as TR's are encountered or 
errors are detected - so it is necessary to perform the.e checks 
every time list output is done. 

See the Error processing section for the handling of list file 
errors. 

3.7 Echo 

The operator must always answer the ECHO? prompt even where not 
applicable (as when list file is lu of operator console, or 
generator is to be directed interactively). If the operator 
requests an echo, then checks are made in \LOUT to see if both 
lALST and lACOM are equal to 0, meaning neither the listed output 
or command input are an interactive device. If lALST or lACOM 
indicate an interactive lu , then one further check is made with 
either LSTLU or CKDLU against ERRLU to see if they represent the 
same interactive lu, in which case no ECHO is done. If more 
than one lu points to a particular interactive device, no checks 
are done to determine if they reference the same EQT. Note that 
because echo is dependent on the command input mode it may 
change as TR's are done to and from the operator console or when 
errcr mode is enabled. 

3.8 Bootstrap File 

At \BOT0,\BOT5 the moving head bootstrap loader may be sent to an FMP 
file or to an lu : a response by the operator implies no boot is 
desired. The "0" must be specifically checked for as the 
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4.0 ABSOLUTE OUTPUT 

The absolute output file for the system being generated must be a type 
1 file because of its fixed length, quick random access features. 
Because type 1 files are not extendible, the user must over- 
estimate the track size of the new system, with the routine \TRUN 
truncating any excess file space at the end of the generation. 
The file size specified is checked for a 15 track miniiium, as is 
a size so large that it results in a negative number of blocks 
(#tracks x 48). When the file created is too small, a GEN ERR 17 
will occur at that point where the end-of-f ile is passed, usually 
a considerable way into the generation. Because the generator has 
to abort, the user usually has to learn this lesson only once! 

Since RTE: requires locations of items on the disc, disc addresses 
within the generated system are relative to the start of the disc 
and thus are relative to the start of the absolute output file 
(exclusive of header records). 

4.1 Absolute Output File Truncation 

The routine \TRUN is called at the end of the generation during 
the cleanup processing. It closes the absolute output file, 
truncating any unused file area. Immediately preceding the call 
is a forced access to the last record +1 (using \DSKI) to make the 
truncate work. A special situation results when the area 
used by the new system is exactly equal to the created size of 
the file. When the forced access is done, an F^JP-12 error 
occurs because we've overflowed the file. The record was 
obviously not read in (makes no difference because it was a dummy 
rr ad 5nyv/c.y), and most irnpcr tant , the track and sector adcresses 
in /ADCB were not set. So /TEUN must check the FMF error code 
still in FMFK from DISKE 's READF call - and if it's negative, no 
truncation is to be done. 

The truncation is done by determining the number of unused blocks 
in the file, and deleting them in the \CLOS call: 

(# blocks in file) - (current block #) = TMP \ 

where the current block # is obtained as follows: 

(last file track - first file track) *#sectors per track - 
(first file sector + last file sector) *2 
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4.2 iieader i<ecords 



The absolute 
These ere us 
SWTCH, witho 
output file 
for storage 

After \STEL 
it uses the 
of a 7905/79 
$TB32 becaus 
does contain 
for the head 



output file contains two, 128-word header records. 
ed as a means of passing pertinent information to 
ut SKICH having to go searching through the absolute 
for It. The track map table (IMT) buffer is used 
of the header record information as it's being built. 

send the Track Map Table to the system storage area, 
TMT buffer TB30 to send header record #2. In the case 
20 this header record will not be identical to 
e It does not contain the number of subchannels, but 

the spares for each subchannel. See Figures 3a and 3B 
er record #2 formats. 



After record #2 is sent, record #1 is built in bits and pieces. The 
EQT information is obtained while the EQT's are being built. lOADD, 
the channel, is placed in the high byte, and lOTYP , the EQT type, 
is placed in the low byte of word pointed to by HEADR (the next 
header record entry) . when the lu of the system console has been 
assigned, the corresponding channel is retrieved. 

Once FSECT has rewritten the track sector boot extension with the 
correct values, it builds the remainder of record #1 as well. 
The format of record #1, and where some of its values are 
Obtained, is: 



word 
1 
2 
3 
4 
5 



1 I SYSTE^^ SUBCHANNEI # 
SYSTEM DISC EOT # 
# OF EQT'S IN SYSTEM 
PEIVILEGEE INTEFPUFT CHANNEL 
TBG CHANNEL 



# OF DISC 
SUBCHANNELS 



SYSTEM 

CONSOLE CHANNEL 



CHANNEL/EQT TYPE OF EQT #1 
CHANNEL/EQT TYPE OF EQT #2 



CHANNEL/EQT TYPE OF EQT #n 



SYSCH 

DPT 2 

CEQT 

PIOC 

TBCHN 

#SUBC/CONTENTS OF 
TTYCH+3 

lOADD/IOTYP 



FIGURE 2 - Header Record #1 
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* bit 15 is set since the absclute output file contains the 
header record; this is usee so the Rlt-lV version of iSVv'iCli 
check against RT2GN/RT3GN-produced output files. 



second 

Con 



HEADEF; PECOED #2 (128 words) 
7900 disc: 



rd 


1 FIRST TRACK, 


subchannel 


1 


1 


1 FIRST TRACK, 


subchannel 


1 1 


2 


1 FIRST TRACK, 


subchannel 


2 1 


3 


FIRST TRACK, 


subchannel 


3 1 


4 


1 FIRST TRACK, 


subchannel 


4 1 


5 


FIRST TRACK, 


subchannel 


5 i 


6 


FIRST TRACK, 


subchannel 


6 1 


7 


FIRST TRACK, 


subchannel 


7 1 


B 


# of TRACKS, 


subchannel 


1 


9 


# Of TRACKS, 


subchannel 


1 1 


10 1 


# Of TRACKS, 


subchannel 


2 1 


11 


# Of TRACKS, 


subchannel 


3 1 


12 


# Of TRACKS, 


subchannel 


4 1 


13 1 


# of TRACKS, 


subchannel 


5 1 


14 1 


# Of TRACKS, 


subchannel 


6 1 


15 1 


# of TRACKS, 


subchannel 


7 1 



FIGURE 3A - Header Record #2 
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or 



7905/7906/7920 disc: 



word 
1 
2 
3 

4 
5 
6 
7 



9 

10 

11 

12 
13 
14 
14 



127 



STARIING CYLINDER # 

# SURFACES, STARTING HEAD, UNIT 

# TRACKS 

# SPARES 



STARTING CYLINDER # 

# SURFACES, STARTING HEAD, UNIT 

# TRACKS 

# SPARES 



STARTING CYLINDER # 

# SURFACES, STARTING HEAD, UNIT 

# TRACKS 

# SPARES 



subchannel 



subchannel 1 



subchannel 2 



subchannel 31 



format: 15-12: # SURFACES 11-8: STARTING HEAD 3-0: UNIT 



FIGURE 3B - Header Record #2 
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4.0 Output Poutines 

\ABDC - May be the most useful routine in the generator It is u=;pri i-r. 
read or write words from the absolute output file, using Ihe 
memory address of the word in the target syste,... \ABDO 
^he'^^^o """5 ^ ^-"""^ ™^P 5i^i"9 thi base diso location, 

memory addr^^^^f '^^^^'^r^^"^ '^^' location, and the highest 
memory address referenced using this map. \ABDO puts out 

adlr^f^M* absolute code word (in A-reg) at the memory 
address (in B-reg) under the current map. Gaps are filled 
with zero codes if the current word falls beyond the 
highest previously generated word. For convenience, three 

maps are automatically maintained. These are for the 
system, a driver partition or a user program, and a user Droaram 
ac?Tv."t: ,^'"'^'^°"""es \SY£,\USER, and \sIgs arlused to "^ ^ " 
activate these respective maps. Other maps could be constri.f^t^ri 
and activated by SETDS. >-"uxa oe constructed 

\DSKD - Translates a disc address to a record number in the Type 1 
absolute output file, thus satisfying the file's random 
access nature. FMP eeadf and Wi^lTE calls are used 
to access the output file in 128-word (sector-sized) 
chunks. Note that an FMP-12 error (EOF sensed) is 
clean!u/\herf,- ''''% "^'°" behind this is that during 
nffrt ^?' t /^ 'f ^ ^""''^^^ ^"""^^^ ^° the last record 
Tr%^L I' ^t^°l1. ^™"*^ ^^ called. This is to set up the 
?rCncat^'th ^f'^T^ i" 'he DCB \ADCB so \TRUN can 
record the absolute output file to the last referenced 
record. \DSKI is used to read in that record but it i^ 
never rewritten (where the error would blsensed'. 

In the special case when the header records are written 
the memory address in the B-reg is set to negative to ' 

tht^f.l "^^T"" "• ^°' "^"^-^ *2 the A-reg^ontfining 
the disc address as well as the B-reg are negative qL 
Header Record Section for the record forma?!! ^ 

\DSKA - ^^^^^^^"ts t, ^^^^^^^ ^^ ^^^^ ^^ ^^^ succeeding 

eqSals'the nLhf "^f ..'" determining track crossings and ^ 
equals the number of 64 word sectors per track. 
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\DSKI - Controls input from the disc (at specified disc and core 
addresses) and uses a buffer making the disc appear to 
have 64 word sectors. 



\DSKO - Controls output to the disc as \DSKI controls input. 
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5.0 PROGRAM INPUT PHASE 

During the Program Input Pha^^ m» 

•pany responses to its proract r«o! generator will accept one of 
Its own command scannefanf branch'mnLonic't'Ar'"'"'^"^ ^ ^°"tai"s 
"f J°"tine CKDIN is called to retrieve ?h^ nf J^* ""^ PRCMD/NXTCM 
called to determine the correr^t oJ;f^ ^ ^ "^"'^ command, SCAN is 
sent to that Processor (Sho ret urnrto'^«5:^?S^^^°'^' ^"^^ =°"trol is 
entered). CMDIN issues the Dro™^^ V^*^"^ ""^^^^ ^ /E was 
\PRMT (Which filters t^^^'l^r^^llT^B^ri^lt^l'''"'''^-'' "'" 

returning 'fprocessoyindex in IttT '°' ^""^ ^°'"™^"'^ keyword, 
some of the individual command ^^^ ^'"^- ^°^" " also called bv 
portion Of the command table such a fMOrfrr .'c '^"'^'^ ^^^^ "eir "" 
"^/^^f^-^ the MAP command: PTAEI is ?h« K^' <=^°«^LS, LINKS, OFF 
seven keyword commands ^nr.f\> ^t • *''^® branch table for the 

RELOCATE and REL) CMDIN catch^.^f,"'!"^^ °' ^"'ries for both 
QGETC catches all * following the ptp °' ^""""^"^ '*> 1^"^, 
while GETAL catches all those fofi^^f commands (on the same line) 
cases the remainder of tL^°lLf "L^^rg^-^.-^o^J^p^rLlng- ^" ^°^^ 
aJl^oe:SL^"^eyw":ra"-^^f^%^i\-^-,-5'-ins an entry for each 

the beginning of a longer keyword (eo ppf^^"^ '^'^ ^^"-^ ^s 
longer must appear first rl^u 1 '^•. ^^^ a"<3 RELOCATE) the 
pieces of inflf bits 15:8 fndLate'Li" ''^ '^'^^^ contains two 
the Ascii keyword, and bits 7-0 contl^n ""'"''".."^ characters in 

in hof.'^f"^ ^^^"^ f°^ that keyword ?h^^S"^^' ^"'° table CMTBL 

in both PTABL and CTABL must nn^ kf ' u ® ordering of entries 

IS of no importance. "°'' ^^ changed, whereas that oIcmtbl 

When called by the Individ. ,-,1 

LINKS) SCAN operates on th^f Processors (of DISPLAY, MAP or 
MTABS and ITAB respec??velv) l^^t'"^^"'^ '^^y"°^<3 tables (l?abs 
index in the A-regf ^^' ' ^^^^^ returning the matched keyword 

5.1 DISPLAY Command Processor 

DSPST makes use of tho .».- 

ONDEFS or TABLF were indicated^'^and ''"^^' ^'°"' ^'^^N, when neither 

for an entry point. If not found .K°"^^''"^""y searches ?he lIt 

an "DNDEFINED" is printed? "''' ^^^ ^"^'^ P°i"t name followed by 
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LSFST will always send its output to both tlu^ opera toi coiv^u'le .\m\ 
list file. Iherefore it is necessary for RT4GN to simulate a TR to the 
operator console (unless already in the interactive mode), do the 
display, and then pop that TR from the stack. The operator never 
realizes that this even happens. If either TABLE or UKDEFS was 
specified, then the routine EPL is utilized (A-reg on entry = 1 means 
list LST entry pts, = means list LST undef ined's) . If a DISPLAY UNDEFS , 
TR is request, the 'pop' will not be done if there existed any undef s 
(A-REG is nonzero on return from EPL). 

5.2 REL(OCATE) Command Processor 

RELST is the most complicated PIP command processor because of 
the optional module name specification allowed before the file name. 
Because an lu cannot be specified for relocatable input, special 
checks are done at CHFNM to insure that one was not entered. \RNAM 
and \RBIN will catch an invalid file name. Note that because of 
the special format of the RELOCATE command - no comma until 
immediately before the filename - \PARS will stick the filename, 
security code and crn in the usual parse buffer locations (see 
File Interface). If a module name was specified, RELST stores 
the name in buffer XNAM; if none specified, XNAM's value is 0. 
So when a Nam record is read checks are performed at LDRC3 to 
determine whether or not to load the module. If no module name was 
specified in XNAM, then the entire file is unconditionally loaded 
(note that "loaded" here refers to module entries being placed 
in the LST and ILENT tables - actual relocation is done later). 
If a module name was specified, then it is determined if there 
exists a match between the XNAM module name and that of the 
current Nam. If no match resulted then those relocatable records 
through the next End record are skipped, otherwise that module 
only is loaded. Two variables are used to control loading: 
SERFG = indicated a module is to be loaded, -1 that its to be 
skipped; NAKR. = when a Nam record is expected (either at 
beginning of file, after an END record, or in record skipping 
mode), = 1 means one is not. 

5.3 MAP Command Processor 

MAPST controls the memory map listing during the relocation phases. 
The value of MAPMD is stored in bits 3-0 of IDS of all IDENT 
entries. MAPMD settings (bit for globals, bit 1 for modules, 
bit 2 for links) are in effect for all IDENTS entered through 
subsequent RELOCATE commands. Options can be turned off only 
by entering a MAP OFF command, and then entering another MAP 
command listing the desired options (more than one can be specified) . 
A MAP statement is processed left to right - therefore MAP MODULES, 
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ALL, LINKS, OFF, GLOBALS would result in GLOBALS only being mapped 
(MAPMD = 000001). The initial (default) value of MAPMD is off. 

5.4 LINKS Command Processor 

LNKST controls the linkage mode during relocation. As for the MAP 
command, the option specified is in effect for all IDENTS entered 
f!^r^"El?..n"^^^?"r'' RELOCATE commands. The initial (default) value 
tor LNKMD is for base page mode; 1 indicates current page mode. 

The value of LNKMD is stored in bit 15 of all IDENT entries. Current 
page linking is never done on assembled type 3,4 or 5 programs (and 
their variations). 

5.5 /E Command Processor 

EOL terminates the Program Input Phase by exiting thru PRCMD's success 
return. Before returning however, it calls EPL indicating a listing of 
the undefined EXT s (if any) - this listing goes only to the list 
tile (not to operator console, as did the DISPLAY UNDEFS 
command) . 
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6.0 IDEN1, LST, and t IXUt Table Structures 

The IDLN'l table contains an entry for each relocatable module 
which is specified by RELOCATE commands during the Program Input 
Phase. There is one entry in the LST for each entry point defined 
in each relocatable module; entries are also created by the 
generator (e.g. for $CLAS> $LUSV^ , $RNTB , $LUAV , $TE31/2) and for 
those EMT's suplied by the user during the Parameter Phase. 
FIXUP entries are used during relocation when an entry point is 
accessed before it has been defined (no address in the LST) . 

These three tables are stored in the available memory space 
starting at the first word following the end of Segment 3, and 
ending at LViAM. ^3ote that the assumption is made that Segment 3 
is the largest segment. 

There must exist at least 512 words of undeclared memory in order 
to insure at least one sector's worth of words for each table. 
Initially the space is allocated: l/4th for the FIXUP table and 
3/8th's each for the LST and IDEMT tables. Once a block of space 
is allocated, it is truncated to a sector-multiple number of 
words. The block size must also be divisible into the track size 
(so that when many blocks are swapped out none will cross a 
track boundary); thus a block may be truncated further by one or 
more sectors. All truncated words are collected and added to 
the LST block, as it usually needs the greatest space and is 
accessed the most. Its block size must still fulfill the above two 
restrictions, however. The maximum block size is 6144 words (ie, one 
track's worth of information). 

Six tracks are obtained for the swapping of these tables: 1 for 
the FIXUP, 2 for the LST, and 3 for the IDENT, If these tracks 
cannot be obtained, the generator issues the appropriate message and 
suspends itself (by re-issuing the call without the no-suspend bit) 
until the tracks become available. 
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6.3 IDENT TABLE ENIRY FORMAT 



word 1 
word 2 
word 3 



IDl 
ID2 
ID3 



NAME 1,2 
NA^aE 3,4 



word 4 
word 5 



ID4 - 
IDS - 



v;ord 7 
word 8 



word 9 : 

word 10 

word 11 

word 12 

word 13 

word 14 

word 15 

word 16 



(15-8) 
( 2-0) 



(15) 

(14-0) 

(15) 

(14) 

(13-4) 

(3-0) 



NAME 5 
USAGE FLAGS: 
2 this module 



1 must 
this 
set if 

COMMON 



word 6: id6 - (15) 



was loaded as part of a segment 

load this module (ext defined by it) 

module was loaded 

main program module 

LENGTH 

BASE/CURRENT PAGE LINKING FLAG=l/0 
NEW NAM RECORD FLAG 
EMA SIZE 
MAP OPTIONS: 
2 links 
1 modules 
global £ 
EMA DECLARED 
SIZE 



ID7 - 

ID8 - 

or 

or 

or 



ID9 

IDIO 

IDll 

ID12 

ID13 

IDl 4 

ID15 

ID16 



(14-10)MSEG 
(6-0) TYPE 

4 SSGA 

3 REVERSE COMMON 
LOWEST DEL ADDRESS 

DISK LENGTH FOR UTILITY RELOCATABLES 
MAIN IDENT INDEX FOR SEGMENTS 
(15-8) " 
(7-0) 
(15) 
(14) 
(13) 
(13-0) 

- FILE 

- FILE 

- FILE 



PAGE REQUIREMENT 



KEYWORD INDEX 
EQT defined 
SDA declared 
SDA own mapping 
DRIVER LENGTH 
NAME 1,2 
NAME 3,4 
NAME 5,6 

SECURITY CODE 

CARTRIDGE LABEL 

RECORD NUMBER 

RELATIVE BLOCK 

BLOCK OFFSET 



TABLE 2 



6.4 LST ENTF^ FOIvMAT 
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word 


1: 


L ST 1 


- NAME 1,2 


word 


2: 


LST2 


- NAME 3,4 


word 


3: 


LST 3 


- (15-8) NAME 5 
(7-0) ORDINAL 


word 


4: 


LST4 


- I DENT INDEX 
or 2 if COMMON 
or 3 if ABSOLUTE 
or 4 if REPLACE 
or 5 if UNDEFINED 
or 6 if EMA 


word 


5: 


LST 5 


- SYMBOL VALUE 

or I DENT INDEX if EMA 



TABLE 3 



6.5 FIXUP TABLE ENTRY FORMAT 



word 1 
word 2 



word 3: 
word 4 



FIXl 
FIX2 



FIX3 
FIX4 



MEMORY ADDRESS 

(15-11) instr. code 

(10) byte instr. indicator 

(S) upper BP link indicator 

(2-0) DEL record type 

OFFSEl 

INDEX OF LST ENTRY REFERENCED 

if local symbol 

-1 if .ZRNT 



TABLE 4 
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6.6 LST Index for .ZRMl 

Since the indices to the LST entries beq in with zero (unfortunately) 
there may be confusion with the value of FIX4,I whose value is either 
the index of the LST entry referenced, or zero for no reference. 
It turns out the . ZPNT is always the first entry in the LST because 
the generator places it there, so it always has the index. 
Therefore, during the DBL relocation processing in segment 4 (at 
DBL45 to be exact) when a . ZRNT reference is detected (a special 
case as it is), then the corresonding FIX4,I entry is set to -1. 
DFIX will later check this value (where here meens to use a 
zero value), but since . ZRNT is a replace operation (\LST4 = 4) 
then the bogus -1 value of FIX4,I is never used. 
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7.0 PRCGRAW TYPES 

0: SYSTEM 

1: FiEKCPY RESIDENT 

2: RT DISK RESIDENT 

3: BG DISK RESIDENT W/ TAII ACCESS 

4: BG DISK RESIDENT W/0 TAII ACCESS 

5: SEGMENT 

6: LIBRARY/UTILITY 

7: UTILITY 

q! lll^irj.'^.^^ ^^^^ TO SATISFY EXTERNAL REFERENCES 
9: MEMORY RESIDENT USING BACKGROUND COMMON 
10: RT DISK RESIDENT USING BACKGROUND COMMON 

ll' RC ni^!^ mi^ll'^n ''^'''^ "'^^'^ ^^''^ ^^^^0^ ''/ 'i'AII ACCESS 
I3; TABLE AREf I? ''^''''' ''^''^ '''''^ ^'"'^''^^ W/0 TAII ACCESS 

15: TABLE^REri ^°^^^~^'^^^^^ ^^^^0 RESIDENT LIBRARY 
16 : SLOVv BOOT 

17,18,19,20,25,26,27,28: TYPES 1 ,2 , 3 ,4, 9 ,10, 11, 12 (RESPECT.) 
-»^ „ with access to SSGA 

30: SUBSYSTEM GLOBAL AREA 
21-24,29,31-99: UNUSED 

(TYPE +80 IS USED TO DESIGNATE AUTO SCHEDULE AT 

pSASE''^%80\f Tn?rr "" "^^'^^^^ ^^ ™^' PARAMETER 
NOT^^nppn Tx, mu^^T ^ ^^^^ ^^^ '^^^ GENERATOR AND IS 
NOT STORED IN THE ID-SEGMENT.) 

TABLE 5 
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7.1 Entry Point Availability Per Program Type 

Because system entry points are not available to every program type 
and entry points in the memory resident library are available 
1°:JIV!1''''X,^^^^^^^^^ Programs only, certain checks must be made to 
prevent illegal references. (See Table 6.) 

System entry points defined in type and 16 modules can be 
referenced only by the system and its tables (types 0,13,15 resoec- 

typel'uJ^!^:^?^ So1rSL"!^^""^°^ '^^^^ ">' ^' -«^ .type-^foTana .y 

■Library entry points defined by type 6 and 14 modules can be 
referenced only by the memory resident library and meniorv resident 

aI?^'vn^ i'^^rw'''3\'"'- ^"t^i^^ the memory res ilent^aref 
ti '^yPt,6^^"<3 14 modules are treated as type 7 modules so 
they will be appended to all programs referencing them. 

referencing'th^m! ^'"^ ' ""'"''^ "''' "" "P^"""^'^ '° ^^^'^ '"°<3"1- 

can'h^ rffi^ *'^^ k"^'^ P°'"'^^ defined by type 13 and 15 modules 
can be referenced by anyone. If Table Area II was not included 

that"t;'s"^:^i^:^;rote^L"dr! '"''' ""^^ '"^ "^^^ ^° refer^:^L^"ft^note 

iiproiir. ^ri^ sicVL^eL-^?y^^L-i^!.^^ar^r-ie 

and another type 30 module. 

^nonl^^"""^^ ^^ ^"""^ ^^ ^"^^^ ^^"^^ ^^^^^^ than during relocatable 
input because of the parameter change capability. 



p 



^> X g g §5 » :i 5 5 X g 3 ^ ^ J p I ^ g ^ g Jf g g g ^ 

OJ 2 5 4- -5 4> n S^ \0 i) t2 l3 l4 \S Kp H iV l^ 20 • 25 24. 27 Z^ . 30 

' __ _ ,... t'e^eYe;nctc- " . _. i. !..... .„_ ....._ 

y -. ^ . - -. »^ / /• ^ ^ - - • ^ / /- - - - "T-"".r, r.. ^ 

V X-- — ^ s^ y ^ ^ — .•/i^v/-- ~; X 

J 3 : I 'Z - ' - - y' 1 :^ «/ - - . - - "^ \^t. / / - — — J- _: — Lrnr^ ^ 

._:.4',.,......; >^ "".,.-L..r. .-_,r„..*i..^_ ^. -:..._:::,. ^iv/^'^ — ■.-r.Lr:.,.~„j::...„.„_ A. 

..^(., ,,:x ■- "_,- - - y x_ >v -'"-■ - -'^IZ^.^.''-^^^^ rl-ZI.^x 

.,1 : X. - - .- .-, - .*!','/. ^_,^_,~ J-....- - _^;v^ / - - --__-- -_ „:.-:-.. L~— -...._ >^, 

<{ X - — --i^v/^---. — ^*^^""-_T ~ ^ T_r ^ 

io X ;• ~ - - *^ :^ i/ -" ~_ ~. ~ r-J^ >4 '^ '^ ~ ~;r.~ .-: X 

ill '/ - - _- : *^ ^>^ ^ ~ - - -. ^"^^y y z.^..z.^..:z^.—.^....:..ri:.-.^:...r'.... ^ 

,il2 .X - "T.r: ~ ':' Ji t/ -- - _r- - .- v/ v^Z.r _^ - - ~ ~; - ^> A 

_;if ^X ~ /XX -> - - /W ^ - ~ -^ -^-.^-^---^^^^^^^^ ^ 



IW 4 / -^ - - - - ^ t/ V - v/ x^ ^ v' 



jjj / ~ ^ ^ i/^ \^ — — ^ ^/^ ^^ y — — 1 - — - '^ 



:^7;/ ;•_--- y;'>'v^^ ~..-:_^--:: -: y ^y / - - -. ^ -. .. ^ . »/ 



[/ allowed references 
X disallowed references 
- don't care references 

Note 1 - allowed only when loaded with a type 3, 11, 19 or 27 main 
Note 2 - all references to type 6 and 14 library routines are treated as 
type 7 utility references when outside the memory resident area. 

Program Type References. TABLE 6 
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7.2 Relocation by types 

type 16 's in Table Area I 

type drivers in partition #1 

type 30 's in SSGA 

type system drivers 

type 13 's in Table Area li 

type SYSTEM 

type 16 configurator 

type drivers in partitions #2 onward 

type 6 & 14 memory resident library 

memory resident's: type 1,(9,17,25) 

Real Time DR's: tvoe 7 (in ifi o^\ i 

tiype 2,(10,18,26) plus any type 5 segments 

Background DR's: type 3,(11 iq P7^ ^.i./ 

Y£e -3,(11,19,27) plus any type 5 segments 

Background DR's: tvoe 4 no on oqx i 

'^ype 4, (12,20,2b) plus any type 5 segmenti 
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7.3 Libraries 

7.3.1 Memory Resident library (MRL) 

The memory resident library contains all type-14 force-loaded 
modules, and all type 6 modules referenced by type 14 
modules or memory resident programs. In order to pick up the 
type 6 modules, a pseudo-lead of all memory resident 
programiS is done. 

Because liDrary routines can be referenced only when in the TT\emory 
resident map, they must be made available to disc resident programs. 
Therefore, after memory resident loading, all type-6 and 14 modules 
are demoted by /DEML to type 7 (utility) modules, so they will be 
appended to all DR programs referencing them. Type 30 SSGA modules 
are not demoted. If referenced before the MRL is relocated, they 
are treated as type 7's. 

7.3.2 Relocatable Disk Resident Library 

The relocatable library contains all type 7 modules. Note that 
these modules include all demoted type 6 and 14 modules, some 
of which may have been included in the memory resident library. 

7.3.3 Library Entry Points list 

The entry points available to the user are sent to the disc in 
three passes. See Appendix C for the physical disc layout and 
the entry formats. 

PASS 1: all entry points defined by type & 16 (system.) modules 
are sent 

PASS 2: all entry points defined by type-30 modules and by type 15 
and 13 modules (Table Areas I and II respectively) are 
sent, in addition to LST types 2 (common), 3 (absolute), 
4 (replace) . 

PASS 3: All entry points defined by type-7 modules (includes 
all type 6 and 14 's). 

The output of pass 1 starts on a sector boundary = DSCLB , 
and contains SYSLN entries. The output of passes 2 
and 3 contains DSCLN entries. 
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7.4 Undefined Entry Points during generation 

To recover from an undefined entry point, the user must enter a 
"DISPLAY UNDEFS,TR" before exiting from the Program Input Phase. These 
undefined externals will be listed on both the operator console 
(regardless of echo) and the list file. If undefs existed, a TR will 
automatically be done to the console for optional recovery. 

The LSa type for an undefined external will be 5 until that point 
where it becomes defined. (Note that a CHANGE EWT will do it even 
after exiting from the PIP). Once exiting from the PIP, it will be 
treated like a type 4 during program relocation; the value will 
be zero (a NOP). Nc error diagnostics will be printed when an unde- 
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8.0 SIZE EESTRICTIONS 

The following limits for ^n RTE-IV System must be enforced due 
to the 32K (15 bit) logical address space of 21XX computers, 
base page ignored. Extended memory areas are not included. 
P (Area X) is defined as the smallest number of pages which 
completely contains area X. 

SYSTEM: 

p (Table Area I) + p (Driver Prtition) + p (Common) + 

P (System Driver Area + Table Area II + System + Configurator) < 31 pages 

MEJ^ORY RESIDENTS: 

p (TAI) + p (DP) + p (COM) + p (SDA+ TAII) + 

p (Memory Resident Library + Memory Resident Programs) < 31 pages 

where p (COM) and p (SDA + TAII) are optional 

RT AISID BG DISK RESIDENTS: 

p (TAII) + p (DP) + p (COM) + p (SDA + TAII) + 

p (a RT or BG Disk Resident program) < 31 pages 

LARGE BG DISK RESIDENTS: 

P (TAI) + p (DP) + p (COM) + p (a large BG Disk Resident Program) < 31 pages 
where p (COM) is optional 

8.1 PAGE ALIGNMENTS 

The following areas are automatically aligned by the generator 
to start on a page boundary: 

Base Page 

Table Area I 

Driver Partition 

Common 

System Driver Area 

Resident Library 

Memory Resident Programs (first one only) 

Disk Resident programs 
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s.o ^asc areas 

9.1 BASE PAGE 

Table 7 describes the various base page formats. Only one (each) 

system and memory resident base page exists, but each disk resident 

program has its own copy of base page. The base page links used 

by a disk resident program are stored in the next disk sector 

following the program's code. The system base page is both 

logically and physically page and is stored starting at track 

sector 2 of the system. The memory resident base page MRBI resides 

in physical memory after the last driver partition page, and the memory 

resident library (MRL) starts on the physcial page after that. Physically 

the MRBP links are stored on the next disk sector following the last 

memory resident program's code. 

The System Communication Area (SCOM) and all Table Area I, SSGA, Table Area 

II and drive links are resident in both system and user maps, the SCOM residin 

in BP locations 1777-1645 and the upper BP links from 1644 downward. After th 

track sector boot extension has been sent to the disk, the 

dummy base page (it resides in core overlciying the initialization 

code of the generator MAItO is written for the sole purpose of 

reserving its disk space. The system links (including configurator) 

always start at location 100 and grow upward toward the SCOM. The 

partition drivers links are not allocated until the PRD's have 

been relocated, so checks are done for overflow of these 

driver links into the system links. ^ The system base page on disk 

is updated at the end of the system's relocation for the trap 

cells and system links. Mote that trap cells referencing programs 

are fixed-up as the programs are relocated. The BP driver links 

are updated on disc after all the PRD's have been relocated, and 

the SCOM is updated during the final generation cleanup. 

iviemory resident and disk resident program links start at EP location 2 

and grow upward. A GEN ERR 16 is issued on 

each overflow into the upper link area. In MRBP the memory resident 

library links are allocated first, followed by those links 

necessary for all the memory resident programs. 
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System BP 
1777 



SCOM 
1645 1 ^ 

Table Areas, SSGA, 
Dr iver 
Links 



SYSTEM 
LINKS 

100 I 

TRAP CELLS 

Disk Res. BP 

17 7 7 



1G4 5 







SCCf- 




i la 


lile 


'" reas , 
Driver 
I inks 


SSGA , 


1 USEF: 
1 LINKS 





Memory Res. BP 
1777 

SCOM 



1645 



Table Areas, SSGA, 
Driver 
Links 



MEMORY 
RESIDENT 
PROGRAM 
LINKS 



Resident 
Library Links 



TABLE 7 
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9.2 SYSTER CCM^lUl\■ICATIO^' PlP.Eh {SCQV) 

The SCOM is built at the end of generation during final clean-up. 
133 octal words below the label USFTK are initialized to and 
overlaid as SCO^J is built, transferred to the dummy base page, and 
then sent to the disk using /ABDO. The base page locations are 
set by the generator variables as follows: 

1645 XIDE}c ID extension address of currently executing program <-0 

1646 XMATA ^mT entry address of currently executing program <-0 

1647 XI address of index register save area 
1650 EQTA first word address of equipment table 
16 51 EQT# number of EQT entries 

1652 DRT first word address of device reference table 
16 53 LUJy^AX number of logical units in DRT 

1654 INTBA first word address of interrupt table 

1655 IMTLG number of interrupt table entires 

1656 TAT first word address of track allocation table 

1657 KEYWD first word address of keyword block 



1660 EQTl 
16 61 EQT2 
1662 EQT3 
16 63 EQT4 
1664 EQT5 
16 65 EQT 6 
1666 E0T7 
16 67 EQT8 



address of SAM#1 

# words 
address of SAM#2 

# words 
address of SAM#0 

# words 



<-0 

<-AEQT 

<~CEQT 

<-ASQT 

<-CSQT 

<-AINT 

<-CINT 

<-ADICT 

<-KEYAD 

<-LVvSYS + l 

<-SA^'#l 

<-LWSYS+l+SAM#l 

<-SAM#2 

<-LWTAH-l 

<-DPADD-(LWTAI4 

<-0 

<-0 
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1670 


EQT9 


1671 


EQTlU 


1672 


EQTll 


1673 


CHAN 


1674 


TBG 


1675 


SYSTY 


1676 


FQCK T 


1677 


RQRIN 


1700 


RCFl 


1701 


R0F2 


1702 


RQP3 


1703 


ECP4 


1704 


RQF5 


1705 


R0P6 


17 06 


RQP7 


1707 


RQP8 


1710 


RQP9 


1711 


SKEDD 


1712 




1713 


SUSP2 


1714 


SUSP3 


1715 


SUSP4 


1716 


SUSP5 



current DMA channel number 
I/O address of time base card 
EOT entry address of system TTY 
number of request parameters, less 1 
return point address 

Addresses 

of request 

parameters 

(set 

for a 

maximum 

of 

nine 

parameters) 
address of system 'schedule' list 

address of 'wait suspend' list 

address of 'available memory' list 

address of 'disc allocation' list 

address of 'operator suspend' list 



<-0 

<-0 

<-0 

<-0 

<-TBCHIsi 

<-SYSTY 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-SCH4 

<-0 

<-0 

<-0 

<-0 

<-0 
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1717 

1720 

1721 

1722 

1723 

1724 

1725 

1726 

1727 

1730 

1731 

1732 

1733 

1734 

1735 

1736 

1737 

1740 

1741 

1742 

1743 

1744 

1745 



XLQl 

XLINK 

XTL^3P 

XTEMP 

XTEMP 

XTEMP 

XTEKP 

XPKIO 

XPENT 

XSUSP 

XA 

XB 

XEO 

OPATW 

OPFLG 

SVjAP 

DUMMY 

IDSDA 

IDSDP 

BFAl 

BPA2 

BPA3 

LB ORG 



ID segment aciclr. of current program 

ID segment linkage 

IC segment temporary 

ID segment temporary 

ID segment temporary 

ID segment temporary 

ID segment temporary 

ID segment priority word 

ID segment primary entry point 

ID segment point of suspension 

ID segment A-Register at suspension 

ID segment B-Register at suspension 

ID segment E and overflow reg. at suspension 

operator/keyboard attention flag 

operator communication flag 

RT disc resident swapping flag 

I/O address of dummy interface card (PI) 

disc address of first ID segment 

position within sector of first ID segment 

EVvA user base page link area 

LWA user base page link area 

FWA user base page link 

FWA of resident library area 



v-O 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 
<-0 

<-SWAPF 

<-PIOC 

<-DSKSY 

<-IDSP 

<-2 

<-LOLNK-l 

<-2 

<-LBCAD 
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1746 


FTCRG 


1747 


RTCOK 


1750 


F.TDRA 


1751 


AVMEM 


1752 


BGOPG 


1753 


EGCOM 


1754 


BGDFA 


1755 


TATLG 


1756 


TATSD 


1757 


SECT2 


1760 


SECT3 


1761 


DSCLB 


1762 


DSCLN 


1763 


DSCUT 


1764 


SYSLN 


1765 


LGOTK 


1766 


LGOC 


1767 


SFCUN 


1770 


MPTFL 


1771 


E0T12 


1772 


EC)T13 


1773 


E0T14 


1774 


EQT15 



FWA of real-time common 

length of real-time common 

FV.A of real-time partition 

LWA+1 of real time partition 

FWA of background common 

length of background common 

FWA of background partition 

negative length of track assignment table 

number of system disc tracks 

number of sectors per track on lu 2 (system) 

number of sectors per track on lu 3 (aux.) 

disc address of entry point library 

# of user available entry points in library 
disc address of reloc. disk resident library 

# of system entry points in library 

load and go: lu, starting track, # of tracks 
current load and go track/sector address 
log source: lu, disc address 
memory protect on/off flag (0/1) 



<-RTCAD 

<- COMET 

<-MEM6 

<-SYMAD 

<-EGCAD 

<-COMBG 

<-MEM12 

<- -(DSIZE+DAUXN) 

<-DSIZE 

<-SDS# 

<-ADS# 

<-DSKLB 

<-LBCN1 

<-DSKUT 

<-SYCNT 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 

<-0 
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1775 FENCL: memory potect fence address ^-0 

1776 <.0 

1777 BGLWA last word memory address of BG partition <-LWASM 
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9.3 COMMON 

The R1 and BG commons along with the Subsystem Global Area (SSGA, 
type 3 module) occupy a single area collectively known as "COMMON". 
Since any program using any of the three areas can "see" (ha- 
map entries for) the others, only the memory protect fence table can 
provide any protection (see its format under MPFT writeup) . 

The order of the three areas was chosen such that a hierarchical 
protection is preserved: 



BG COMMON 



RT COMMON 



SGA 



A 




page boundary 



The memory protect fence will be placed at A, B, or C if a program 
is using COMMON. 

When the IBENT's are scanned for ID segment allocation at the 
end of the PIP, the common sizes of each program stored in \ID4 
bits (14-0) is used to set the maximum RT and BG common sizes, 
CGMRT and COMBG respectively. 

Starting on a page boundary after the driver partition all SSGA modules 
are loaded first, followed by the allocation of the RT and BG 
common area. 

The RT common size is displayed, the user is given the option 
of increasing it, and the starting address is displayed: 



decimal words 



FT COMMON XXX XX < 

CHANGE RT COMMON? 

NNNNN means no change; GEN ERR 14 issued on an invalid response 

RT COM ADD XXXXX < octal address 



rnM^n lu^^ u ^^ common starting address from PPREL, and 

■^f^rVino ^^J^"" "" ^^ ''''^^^' ""^y*"^ updated; BGBKD is set to the 
dieni'vpri '^^^^^ ^^^? common, PPPEL+COKFT. Before COMBG is 
tlTrf^tf' ^^' updated to include that area from BGBND to the 

the next Lof ho nr"""%^^^ ^^"^ '^ automatically aligned on 
tne next page boundary after BG common). The followina c,pauenrp 
occurs for BG common determination: roiiowmg sequence 

BC COMMON XXXXX< decimal words (new size) 

CHANGE BG COMMON? ' 

BG COM ADD '"xxxxx"'' ^*'^"^^' """^ ^""'^ ^' ^"^"^^ ^^ ^^ ^"^^^^^^ response 
BC COMMON XXXXX< — -decimal words 

addedTrit'^Ln^^-'^'^'^^^^f in page multiples so COMBG has NN-1024 
aaaea to it, ana is redisplayed. 
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9.4 CCNFICURATCH PRCCBAy 

The configurator program is a special system module of type 16. It 
has access to all the system entry points and is loaded immediately 
after the system in what will later be the beginning of System 
Available Memory (SAM #1). its base page links are included with 
those of the system. The last word must not be greater than 
77577B or a GEN ERR 18 will result and the generation will 
be aborted. The memory above 77577 must be reserved for the disc ROM 
loader. The last word of both the system code and configurator code 
must be saved (in LWSYS and LWSLB respectively) in order" to ccmpute 
the size of SAM #1 at the beginning of the Partition Definition 
Phase. SAF #1 will include that specific memory area covered by 
the configurator plus any remaining area left on the last page occupied 
by the configurator. 

The configurator references the Table Area II entry point $SBTB which is 
the first word of the following 6 word table: 

$SETB disc address of driver partitions 

# of pages for all driver partitions 
disc address of memory resident base page 

# of pages for memory resident base page 

disc address of memory resident library and programs 

# of pages for all memory resident library and programs 

The values are stuffed into $SBTB when the generator sets the 
values of all the Table Area II entry points specified in $$TB2 at 
the end of the partition definition phase (see Section 12.8). 

9.5 BOOTSTRAP AND EXTENSION 

The generator builds both the track sector boot extension and 

moving head bootstrap loaders for either the 7900 or 7905/7920 discs. 

Generator segment 1 builds the 7900 bootstrap loader whereas segment 7 

builds it for the 7905 etc. The generator stores the system 

subchannel disk specifications in the bootstrap loader (i.e., first track, 

# of tracks, starting head, # surfaces, etc.), and for the 

moving head bootstrap loader, configures the disk I/O instructions to the 

select code of the system disc. The high address of the configurator 

is stored in the track sector Doot extension in HIGH so the 

first chunk of memory can be read in from the disc starting at 

track sector 2. The generator also sets the following values in 

the boot extension: 

TEASE 

U#NIT 

B#MSK > 7900 only 

SKCMD 

RtCMD 

BHD# 

#HDS 

WAK 

SKCMD / 7 9 05/2 only 

AD#RC 

R#CMD 

S#TAC 
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10.0 TABLE AREAS I AND II 

The generator-built track map table ($TB31 or $TB32) , EQT's and 
extensions, DVMAP table, DRT, IWT and all type 15 modules will be 
loaded and/or stored in Table Area I (in that order). Table Area I 
exists in all maps. The user-available entry points to system 
code will be loaded into Table Area I from the type 15 module $$TB1. 
Note that all user-defined track map tables will have to be 
type 15 modules in order to exist in all maps. The space left on 
the last page occupied by Table Area I is allocated to SAM (SAM #0). 

Table Area II contains (in the following order): 

$CLAS table 

$LUSW table 

$RNTB table 

$LUAV table 

$IDEX table 

ID extensions 

keyword table 

ID segments 

$MATA table 

$MRMP map 

$MPFT table 

Track Allocation Table 

$$TB2 entry points 

type 13 modules 

Type 13 module $$TB2 contains the entry points to system tables 
most of whose values are set when the $MATA, $MRMP, and $MPFT 
tables are built during the Partition Definition Phase. Since 
Table Area II is included only in the system, memory resident 
(optional), and type 2 RT and type 3 BG program address spaces, those 
type 4 BG programs wanting to access any Table Area II entry 
points must do so via cross-map loads. 

All external references from the Table Areas are resolved thru fixups 
once the system and all drivers are relocated. The Table Areas can 
reference each other, the system, and types 6, 7 and 8 utility modules. 
Their links are included with those of the system. Table Area I starts 

?oi?oEe^^K''''r'^f''^'r.^^^^''''^"^ the base page. Table Area II immediately 
follows the System Driver Area m memory , so both are mapped in 
when either is referenced. 
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10.1 EQUIPMENT TABLE (EQT) , DEVICE REFERENCE TABLE 
INTERRUPT TABLE (INT) SIZES 



(DRT) 



The maximum number of EQT and DRT entries is 63 and 255, respectively. 
f,iTJ ^ ^!?? ^^'^ ^""^ DRT entries are sequentially prompted, the 

generator will issue a GEN ERR 35 for all entries past the 63rd or 255th 
until a /E IS encountered. The size of the DRT is always twice 
the number of LU s defined (CSQT), with the second zero-filled 
chunk of size CSQT following the first. The first CSQT words of 
the DRT are set as follows by the generator: 



15 11 



5 

I Subchannel | ( eqt number 
of device of device 



The INT contains entries for each channel from 6B thru 77B, even 
though the user may not have defined up to the maximum. The entire 
channel spectrum must be present for possible I/O channel reconfigura- 

^.nS ^^T?^^y ^''''^ ^^"^^- ^^^^ ^Iso implies that base page location 
iOOB will always be the first SYSTEM base page link. All I/O 

Mcp^'iSe^ ?^°"^ 2^ thru 77B are initialized to the absolute code for 
Job :?LIC,I , except that location 4 is initialized to "HLT 04". 

The INT records are processed as follows: 

1. N1,ECT,N2 - The address of the EQT entry specified by N2 is set 
"TCP ^<^rn^^il ^''^''^ designated by Wl. The INT location contains 

^' ^^^'-^^'^^^^ ~ ^'^^ ^'^ complement of the ID Segment ADDR for 
PNA.^E is set into the INT entry Nl. The interrupt location 
contains "JSB $CIC,I". 

3. N1,ENT, ENTRY - The INT entry specified by Nl is set = and 
the interrupt location Nl is set to contain "JSB X,I", where 
X IS the BF link address containing the address of ENTRY. 

4. N1,ABS,XXXXXX - The INT entry specified by Nl is set = and 
the interrupt location Nl is set to contain "XXXXXX". 

All locations in the Interrupt Table from 6B to 77B which are not 

arTtypes ^^and^'^^^Ai i %^f '^' ^ ^' '^^ ^^ = ^ ^^^ ^"^^ ^^^^1 ^"tries 
orLr ff^K f^ ^ ^^^^ records must be entered in increasing N 
order, with the exception ot 4. 

for ENT tyi^e entries, the entry point referenced must be contained in 
a type mocule . If that type module is a driver (IDENT word 8 bi? 

word 8^bi[ 14^is set)f''''^'' """'^^ ^^ '"" ^^^ ^^^'^^"^ ^^^^^^^ ^^^^ ^^^^^^^ 
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10.2 DRIVERS and EVf.AP 

Drivers will be relocated to reside in either a driver partition or 

the System Driver Area (SDA). The I/O tables (EQT's, DVMAF, DRT 

and INT) are sLcred in lable Area I, and are therefore iiuilt ')<-f:i>ri-, 

ir.y drivers have been relocated. Fixups are then 

resolved for EQI words 3 and 4 once a driver's initiation and 

completion sections are relocated. The two FIXUP table entries 

will automatically be allocated when the EQT is built. The fixup entries 

are bui]t as follows; 



(in EQT) where address of I. XX or C.XX to 
DEL record type =5 



word 1: memory location 
be stored 

word 2: instr. code = 0, 

word 3: offset =0 

word 4: LST index of I. XX or C.XX 
Setting the DEL record type in word 2 equal to 5 simulates an external 
reference with offset. With the instruction code equal to this indicates 
a DEF to an external with offset (of 0) at fixup time, therefore making 
it direct. 

All drivers (identified as type modules beginning with "DV" ) will be sent 
to driver partitions unless so specified by an S or M in their EQT 
definitions as an SDA type. Those drivers without an EQT and 
possibly not beginning with "DV" will be relocated with the system. 
If an SDA driver is to do its own mapping, then an M in addition to 
or in place of the S may be specified. 



When an EQT is defined, 
is retrieved (a GEW ERR 
is built the driver's ID 
valid EQT existed, bit 1 
set if the SDA driver is 
without an S, then an S 
If bit 15 indicates that 
previous EQT, then the n 
bits 14 and 13 of the cu 
by the new entry, otherw 
EQT would have to be red 



the IDENT table 
25 is issued if 
EKT word 8 , bit 
4 is set if SDA 

to do its own 
is assumed and 

a driver had a 
ew type must ma 
rrent entry mus 
ise a GEN ERR 2 
ef ined. 



entry for the named driver 
not found). After the EQT 
15 is set to indicate that a 
was declared, and bit 13 is 
mapping. If an M is specified 
both bits 14 and 13 are set. 
Iready been specified in a 
tch that of the old. i.e., 
t match the values to be set 
3 would be issued and the 



The system disc driver cannot reside in SDA. When an EQT's select 

code matches the "CONTROLLER CHNL?" response, the system disc EQT is 

assumed and a check is made to make sure that SDA was not declared 
for this driver - or a GEN ERR 23 occurs. 

The first half of the driver map'table DVMAP is dynamically built 
in a buffer as the EQT's are defined. DVMAP consists of two 
consecutive chunks of size CEQT (the number of EQT's). After all the 
EQT s and EQT extensions have been built, space is reserved for the 
DVMAP and it is sent to the disc. Table Area II entry point $DVMP 
IS set (later) to its address. The first CEQT chunk has values stored 
m It by the generator, while the second CEQT chunk is zero-filled 
for user by RTIOC. A 64--word buffer (maximum # of EQT's) is used 
for building the first part of DVlViAP. The dummy entries are built 
as follows, with word corresponding to EQTl,...word CEQT-1 
corresponding to EQT CEQT: 
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15 14 8 7 

1^1 I IDENI inoex of driver | for a partition resident 

- driver (PKD) 

or I 
15 

' ■'■ ' 111 for a System Driver Area driver 

SDA driver does own mapping 

The PRD entries in DVMAF are updated on disc when those drivers are 
relocated; the SDA entries are left as defined. The final PFD form 
is: 

9 



I physical starting page | 
of driver partition 



When a PRD is relocated into a partition, all the EQT entries in 

DVMAP must be scanned for an IDENT index matching that of the driver. 

All matching DVMAP entries are then replaced with the driver partition 
starting page. 

10.2.1 SYSTEM DRIVER AREA (SDA) 

All drivers going into the System Driver Area are relocated following 
the construction of Common. Since Common always ends on a page 
boundary, the SDA always begins on one. 

10.2.2 DRIVER PARTITIONS 

The defaulted driver partition size is two pages - large enough to hold 
any HP partition-resident driver. As many drivers are relocated into a 
DP as will fit, so increasing the DP size will allow more drivers to fit 
into a particular partition - possibly saving physical pages if a lot 
of leftover page space can be used. For partition-resident drivers 
greater than 2 pages, the DP size must be overridden in order to accomodate 
It. Otherwise, if the driver overflows a DP at relocation time the 
generation will be aborted with a GEN ERR 59. 

The current DP size is displayed in decimal number of words, and the user 
IS given the option of increasing it: 

DRIVR PARI 00002 PAGES 
CHANGE DRIVR PART? 
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rPTr. t^r, Implies no change, otherwise the new size must be > = 
DPLN and less than 17 (a blue-sky estimate). If an invalid resccnse 
IS entered then a GEK ERR 01 is issued and the query re-DromDted?h» 
new value of DPLN is used to set the Table Area l! entry^poTnt ?DLTH 
Ihe last word occupied by Table Area I is founded up to the next ola^ 
SAK) nP?rn '^°'^\'^, ^^^^° (the skipped memory i"la?eralJocatld^?o 
frii*TTf converted to a logical page number is used to set Table 
Area II entry point SDVPT (starting logical page of driver oartlMoni 
Memory skipped in the page alignment ii "sent" to the dilc bv nnL??i; ^k 

DVMAP table in order to pick up its IDENT index. ceraporary 

Once a driver is relocated, a check is made to see if the loaical 

thf'Tr™.'Pf°K/=^^ ^°' ^ driver partition has been overfLw^ Jf not 
the IDENT table is scanned for a driver that will f<Z <^i^ fS* " *' 

space Of the DP. The scan always begfns a? the beg nnngo"?hriDE{5T"^ 
that'it'e??riif '"in t^t''' m^ specified in x'lDe^of'i^s entry"! Sdicate 

th?:Lh"?hf I^EKT"t\^' ''' ''''''' '' ?e!ocat2dr otherlJilf^fhe-scan ''^ 
cnrougn the IDENT table is continued. 

Note, that however, that a driver may still overflow a partition 
durLrL^o^^t" when referenced subroutines are appended to the driver 
fn er?nr^=^^ ?^ "P°" overflow, the violating driver is 'backed-up^ over 
continued' c^^K^ ^ warning) is issued, and the IDENT table scan is ' 

continued, searching for another drivpr th;:.^ wi i i 4=,- 4- mu ^r„-, 

are not updated for'the overflowed driver "^heipixu^s to'dr^er Intrv"' 
the" ■LuP^:ble°''1hus^'n^r'°^^^^°[;' '^^ -tries'LTno? d^llt^d^" o^ 

once the references are^imolv%'^ f*^'"^ " ^'^^^l " relocated more than 
„i^i-.^- 't^erences are simply re-fixed up to the final value The 
violating driver will be relocated into a subsequlnt partmon.' 

fn?ed° ""Zl ^'^"^'^ can fit into a partition, the remainder is zero- 
DP 'bu^ forth":therDP-s^:e"ro*'fnrT''d' '^ 'T' '° ^^^ lasrword°of a 
c^o-iftrpaTef -of^-pll^^ £^Lt: -- - ^e-av-d-her--nr- ^re^^ 

r:sldenn?br^^?y"^r^u???!- '"'' '^^"^ '^"'^ '^ =^— <^ be^fLe'^'the 'memory 
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Ts done Lc^u^^%h^L^^-^^^*^" "? '^^* °^ <^"^^^ partitions. This 
1^ oonc Decouse these driver partitions reside loqicallv in 
the system area, but physically on the di=c and Dhv^trtTli ir, 
'u^tef^the'rP ^y^^^^"-• "-"- thln'on! «hen"e^crnei\4"is 

rfrL'tion'irLo"J°""^^'/!:! physical starting page of that driver 
partition IE stored m all the DVMAP entries referencina that driver 

Note tha"t the'xAPpF" '""'"? t° ^^^' "°^^^ ^ and Tare also resolvld!" 
to perform th.^rTKr^.'""" ^^ changed to that of the system in order 
-?-,rff^ fl' f ^J^^^ ^'^^^ ^ updates. When a new driver partition is 

;ages1equired bv orL^^^^'S'' ^'"^ '' ^"^= PAGE#<— PAGErrnu,.ber'o£ 
pages required by previous driver partition «DPLN) . PAGE# is initially 

set, for driver partition #2, to $ENDS which is the nhvo^^si r,-„» 

Te%^yinii%l^eTol ^Vl. l^ ''' ''^^^'^' ---' ™ap inTp^endix O.) 
pnysicai page for DP#1 is the same as its logical page, $BVPT. 

Partition driver links start at BP location 1644 and grow downward 

the system -A GEN ERR16 results and the generation is aborted! ^ 

Nicte, a user-entered disc Track Map Table (e.q STB3] or -iTRi^i m.-o^ 
be defined as a type 15 module so it will blllaced In Table ' "'' 
Area I for access by drivers. xauj.e 



10-7 



10.3 ID SEGMENTS AND EXTENSIONS 

to real-time and backarof,nH^?L''"-^^°:?^ ^° segments are allocated 
xr, =;„Z„ t ^ DacKground disk resident programs; mem res 

for 3r *° "'^'"°'^ resident programs; short ID segments 

an Em prL'?ir" rtT^'>^'- ""^ ^^ extensions for each^ong ID segment of 
an t.KA program. The minimum number of each tvoe nprpc=o = rw ic^K^^- S 

\lorr,:\T.t is'al'e !:^ri"^ °" the. prog rar?^pe"^rndE"^ f a°' n'"^' 
exL'Asions afloc^^r thr"u'tL°^^°L'es: '^ '" '^^^ '''"' '^ ^^^"-^^ -<^ 

# Of BLANK ID SEGMENTS? 

# of BLANK SHORT ID SEGMENTS? 

# of BLANK ID EXTENSIONS? 

segmen?f ir>2^4'^^Tf "^ ""tt "^"^^^ "™'^" °^ 1°"^ ^"d mem. res. id 
anrblanks a e r;quest:d'%herthro'r l" "r""'^*^ "^ required'before 
GEN EKR 60. A GEN eIr 01 is aivpn ^if ty,^^°' k''°''^^ ^^'" ^^^^^^ the 
the number of long ID segment's. ^' """''" °' '° EXTENSIONS exceeds 

alLcatedlor'L'oh'^n '^ ^''^ension table (5IDEX) have one word 

^tt «^l « 1. °^ ^^ segment and ID extension, respectively - nine 

ThI ID^m^nt'adlrlsse's ^^^he in^ '"''^"l' '^^'^ e^triel^'L s^t"to 
H.irir,^ ^^ynifc^nt aaaresses as the ID segments are being built nr 

ID extensioi tih?""^ ^°L"^ '''""' ID segments generated "kl 

andlD%"lg:Lts''%hen buUt° "the" ?n'°"f ""''''" '^^ '^^^*'°^<^ ^able 

ir ; I ^e^t^ Lf^^^ fn^r'r" '°' ''' <^-oription of the^^alLl^s^^red 



ID 



segment entries are built as follows: 
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ID SEGMEin V.ORES SEl DURING GENERATION 



(2-0) gives TYPE 
scheduled program 



from 





1-5 

6 PRIORITY from NAM record 

7* PRIMARY ENTRY POINl 

8 

9 

10 address of ID segment word 

11 

12* IDl gives NAMEl & 2 

13* ID2 gives NAMES & 4 

14* ID 3 (15-8) gives NAIIES; ID6 

15 optionally set bit if the 

16 

17 resolution code and execution multiple 
MAM record 

18 Time word from NAM record 

19 Time word from NAFt record 

20 

21 ** (see Delow) 

22* low main address from PPREL 

23* high main address from TPREL 

2 4* low BP address from PBREL 

25* high BP address from TBREI, 

26 main aisk address from DGKMN 

27* 

2b ID EXT# & E^iA SIZE - see EMA section 

29 high main of largest segment = TPMAX, 

30 (session monitor word 1) 

31 (session monitor word 2) 

32 (session monitor word 3) 



-^ 



MEMORY 
RESIDENl 

ID 
SEGMENT 

plus 
words 
30j 31j 



32 



else 



3 



* short ID segments 

** RP bit 15 may be set during the Partition Definition Phase. 

# pages required (14-10) set at end of main program load by IDFIX; for 

EMA programs includes MSEC size; may be changed for non-EMA 

programs during the Partition Definition Phase. 
MPFI (9-7) set at end of main program load by IDFIX. 
Partition # (5-0) may be set if assigned during PDP. 



TABLE 8 
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12.3 JrAFlI^ICiv ^LlL.l'.lCb 

1h€ nierocry allocaticn table (t-AT) and the entry points cescribing 
it are Iccatec in ^;aJDle Area II. V^hen the maximum number of 
pcrtitions ^>\^'Mr is set by the user, the space for that number oii 
rUT entries is reserved with $MATA pointing to the first entry. 

a he nurriber of remaining physical pages (DFAFF, the memory size stored 
in NUKPG minus the first partition page PAGh#) is next displayed to 
the user for partition clef ini t icns . The link word (word 0) of each MAT 
entry is initialized tc -1 to indicate an undefined par ^^ition, 
\vhereas wore £ 1-6 are set tc 0. Note that since the MAI is already 
on the disc it must be referenced thru its absolute memory address, 
updating the code en the disk via \ABrC. See Table 9 for the format 
of a K^T entry. 

The user is proiiipted for the definition of each partition starting 
with "PART 01?% arc stopping when a *' /E" is entered by the user.' 
The physical pages will be sequentially allocated to the MAI entries 
anc the first -1 link will thus indicate the end of the defined 
partitions. The user enters the number of pages, partition type 
(either Rl , EG or S) and optionally the reserved flag. 

'ihe number of pages, less 1 to exclude the base page, is stored in 
MAT word 4 oits (9-0). If a RT partition, bit 15 is set in MAT word 
5 (cleared for EG partitions). If a reserved partition bit 15 
is set in MAT word 4. If the partition size is greater than the 
maximum addressable size MAXPG, then the user is asked if they 
want to define subpartitions. A m response simple results in a 
large unchained partition being defined. If the user responds YLE 
then that partition becomes a mother partition with bit 15 set in 
word 3 of its r^AT entry and the MAT subpartition link word (6) of 
the mother partition is initialized to point to itself. At this 
time only can subpartitions for a mother partition be defined. 
The user has the option of responding YES and still not defining 
any suDpartitions; this would result in a chained partition with the 
mother partition the only element in the chain. The generator prompts 
tor the next partition definition. If the type code is S then this is e 
subpartition for the current mother partition. The partition type 
(either Kl or FG) is carried from the mother to the subpartitions. 
xhe size of the subpartition cannot be greater than that of the mother, 
or a GI^' LPF: 56 will be issued and the partition must be redefined, it 
can however be larger than WAXPG, but further subparti tioninq is not 
allowed. 



l?-4 



'Ihe sum of the subpartition sizes cannot excee6 the size of the 
rpother, but way be less - a GEN EiR 46 results en that subpartition 
definition causing the overflow, anc' that partition must be redefined 
If the type is F'l or BC, then v«e've left: the subpartition mode and 
are proceeding as ncrjnal. 



15 



14 13 



wore 







FRt, E LIST LINK Vh;CRP 








PPIORITY GF 


RESIPEMI 








ID SEGf'IFNT 


AEDRESS 




1 ¥ 


1 


r 1 1 


STARTING PACE 




1 u 


1 c 


1 


eue;eef pages 




1 i:<T 


1 






Rd Comp 1 






Subpar tition 


Link Vs'ord 





M =■ f ■: G t h e r p a r t i t i o r bit 

.15 = CoriViant bi. t 

R = Feservec bit 

C - chain in effect bit 

R'l - H e a 1 - 1 i ire p a r t i t i c n bit 

Kd= Read completion 



T/'BI.E 9 
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li.i.l lie icllrwirc recuerce occurs for a partition cefiniticn: 
.". If [:IXar=f..?XFT then Ect the XX in the prompt to blarks. 



^' ^^ the prompt "PPFt XX?" for the definition of partition XX 

to thf partitfcrcr- " 7'" '' "^'*"^<^' t^^ generatoi proceeds 
rrnri , A? i Cleanup at C. If KEXTP > $KNF then no 

C. Retrieve the partition size, subtract 1 for the bat ^ paae and 
store m rP£lz. DFSIZ must be between 1 and 1024 page" el^e 
issue GFM EFP 45 and go to A. P°geo, else 

"* ftherl^ue ^rPM^rP^ iF" i'^^'^"^' °" ^' ' " neither RT.BG or 
S then issue s GEN ERP 46 and go to f (after clearing SUBS?) . 

'■ issue'rcFrop :rLd l."i^'r'^' -^partitioning enabled, else 
'• EFF^'f a^d'gf tf.!'"'' °' '"^^''^'^ partition, then issue a GEN 

'^* i-ufrrf.^pp^'^r^ (current subpartition page total) > MOMSZ then 
issue GLf' EKP b(-> and go to A. 

"■ 'eT'typf rf ^b^TrTi .TnlT'' .t\'''^^^'^'^'°^'' SUBT<-StJBT+DPSIZ4l; 
type ct subpartition to that ot mother, DFTY<— KOMTY. Go to J. 

'■ and'cuBFr'i/!?et .^^^.^'^^^ular partition (i.e., non-subpartition) 

let DITi to 1 ?cr R-r o '""k^ fr f'^^^y been in regular mode), 
nil: to 1 for, FT sc bit 15 ot word 5 can be set. 



J. 



parti tJor^/n,fr'^' '\"5e^'' logical partition size) then this 
partition may be split into subpartitions. Subpartitions th^-m 

Therefor:%h: '.ff '^;-^"*- '*^^^ "^""°' ^' furthersubdivideo' "^ 
iheretore the subpartition mode flag SUBMr is checked- if - n 

is to be .^krH Tf ?K^ ^ ^"^ ^^^ ^"^ ^ indicating that the user 
IS to be asked it they want to define subpartitions at I. 
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K. Retrieve reserved flaq. If one entered, set bit 15 for word 4 
(r:PFSV< — 0, -1 otherwise). 

L* if SUES? = then qots N, else Drompt the uf:er "SUBPARTITIONS?". 

M. Xf KC then gc tc ¥, If YES; eratale subportiticr mode SUEF'D< — 1; 
store address of current (mother) MAT address in MOM AC; save 
mother partition size for subpartition checkinc, V^OMSZ< — DPSIZ+1; 
clear subpartition total, p:UBT< — 0; save mother partition type 
for its subpartitions, MCr''TY< — DPTY; and set bit 15 for wore} 3 of 
current MAT entry making it a ifiCther Pcrtitirn (DPfiO^. = -1, 
otherwise) . 

i:). Build the new MAT entry (words & 3 are completed during 
partition cleanup) . 

v-^ord 0: set to to indicate a defined entry. 

word 3: DP^'^C^! is used to (cpticnally) set bit 15 if a 

mc t he r par t i t ion 
wore 4: DPPSV is used to (optionally) set bit 15 if a reserved 

partition, and DPSIZ is stored in bits '3-0. 
word 5: DPTY is v^ec to (cpticnally) set bit 15 if a RT partition 
word 6: if SUBML'^l then set to MOKAD, else 0. This will set the SLW 

(Subpartition Link Vvord) to point to itself if the 

mother partition, or to the mother MAT entry if e new 

subpartition at the end of the chain. 

0. If SliLrib=l and SUBS?=-G then at least one subpartition has been 
defined. The current subpartition must then be linked to the 
previous t'^AT entry (which is either the previous subpartition 
in the chain or the mother partition). Fince CURMAT is the memory 
address of the current MPT entry ," then $ (CUF:.H AT- 1)< — CUFMAT. 

P. SUBE?-0, DPFOK< — 0. Bump NEXTP. Co to P., 

g. Partition Definition Cleanup, The ¥PT is scanned, summing up the 
individual partition sizes, until the first undefined entry is 
found (link word = -1) or the end of the table is reached. 
Only the regular and rorther partition sizes are included in 
the total, and 1 is r ddod tc each of these sizes because the base 
page was not includeo in the size stored in word 4, Subpartition 
sizes are not incJuded, their pages having already been included in 
the mother partition; a subpartition MAT entry is detected by 
word 6 (^rw) being nonzero and the mother bit (15) not being 
set in word 3. If the total numDer of pages occupied by the 
defined partitions (DPTCT) does not eoual the number available 
(DPAPL), then a GIN fPP 53 is issued and all the partitions must 
be redef ined . 
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12.3.2 FFi: E LIS'1£ 



threc'f^P^ f|'?^"'^-^r ^"^^^^ (resident on the disc) is sortea into 
.offtnn^L 1 ^ '^^"i^' baseo on increasing partition sizes, by 
setting the link addresses m word of each mat entry. The lists 



separating real-tirne, background and chained (mother) partitions, 
are referenced thru the Table Area II entry points SRTFR Sbgpr 
ano $CFR respectively. t-'^-'j-ntb yiMnt., :?bbtK 

The generator starts scanning the MAT with the first pL'tition's 

entry ana stops when the end is encountered ($MNP entries have 

been threaded) or when the first undefined entry iTfolT6 Uink 

iniMllT.o^ fi n r ^"-^^ l?eaders DPBTL, DPBGI and DFCL are 

tL list header^f and ^h^iH^'t^'^ ^^ DPRT., DPBG., and DPC. , respective] 

e^f4-ti.. r^rf T u ^"-^ lists) are accessed and updated by 

setting LPLli.,i where BPLH . is set to one of the header pointers 

depenaing on the partition type. The partition typris ^:terMn;d as 

If the mother bit of word 3 is set then both RT & BG mother 
partitions go into $CFR, or if the RT bit of word 5 is set 

lict TL^fLf^^^'f'^i^'f ^ "^^'^ ^^^ remaining go into the $BGFR 
list, -ihe type of list being threaded is irrelivant once the 
particular header address has been set. ^^-^^^ant cnce the 

Ph%ctcal^'L"^'Te''''^ ^^^^'^ '^ ^^^'^^* ^^^^' ^ ^i^t' its starting 

physical page IS stored m word 3 bits 9-0. dpqrg is initially set to the 

paqe' arf-^f^rfJ'' f^' Partitions from PAGE# , and is updated as ^ 
pages are «llccateQ to a partition. Vvhen a mother partition i- 

theTx^n ;.'-?''^ '' ff' '"'^^" '^^^^^ '' ^P^^t^^ to^he start'f 
the next pdrtiticn. When MORG is non-zero, the next set of c,„h 

'^t^vTrrr^'H^' '"! ''^ '^'^ ^^^^ ^^-^ starting ^hysi^al page 
next Ln^su^^^^ incremented after each subpartition). \hen the 
ntxr non subpartition is encountered, MORG is cleared ana etsrtinri 
pages are set by DPCRG again. ^xt.area ana .torting 

^vhen the threading is completed, the last element in each list 

?n ^hl ^'re set to the page sizes of the largest non-reserved partition 
in the real-time, background, and mother free lists, respectively 
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12.4 MODIFY FFOGRAM PAGE KECUEF^:E^^TS 

The IDLt^/r entry for the named program is retrieved; a GEN ERR 48 
is issued if the program naipe can't be fcund or if it is of 
incorrect type. Cnly disk resident programs (masked types 2,3, 
and 4) executing in user partitions can have their page requirements 
increased. The page requirements of an EMA program cannot be 
overiaden, sc if bit 15 of \ID6 is set, a GEN EFR 55 is issued. 

When the program's ID segment is built, the keyword offset is 

stored in the program's IIEin entry word 8 bits (7-0). The routine 

IDFl'D retr:}.eves the proniara's ID segment address by going thru 

\XD8 and the keyword's value stored on disc. Before the program's ID 

segment word 21 can be updated, the new page si?e must be verified. 

The program's lew main is retrieved from ID segment word 22 and is 

converted to its starting page to which is added the new page 

requirements (less 1, stored in DPSIZ). If overflow occurs (>32) 

then a GEN B.R 51 results. A program's page requirements, stored in 

its IDir^T entry word 8 bits (15-8) when the ID segment was built, 

are compared against the override in DPSIZ - if DPSIZ is less than 

a GEN ERR 51 again is issued. Otherwise DPSIZ is stored in ID 

segment word 21 bits (14-10) of the named program. The page requirement 

in \IC8 is not updated, however to allpw a re-cverride. 

12.5 ASSIGN PROGRAM FART II IONS 

The IDENT entry and IE segment address for the named program are 
retrieved as when modifying a program's page requirements. Only 
disk resident programs may be assigned to partitions, provided the 
partition is large enough to hold the program. A GEN ERR 49 
is issued if the partition number specified in DFNUM is greater than 
the maximum allocated (r^AKFT) or if the partition is undefined 
(link word = -1). The size of the partition is 
retrieved from its MAT entry word 4 bits (9-0) and stored in 
DPSIZ. The page requirements of a non-EMA program are retrieved 
from ID segment word 21 compared againgt DPSIZ. A GEN ERR 50 is 
issued if the program is too large for the specified partition, 
otherwise wora 21 bits (5-0) of the program's ID segment are set to 
IPtU^i -1 and the RP bit 15 i£ fiet. 

for Ei^A programs (bit 15 of \ID6 is set) the page requirements stored 
in \IE6 bits (15-8) include the MSEC size, but it is the EMA size that 
must be included when considering whether or not the program will 
fit in a partition. The program code size is determined by subtracting 
the ^ SEG size in \IE6 bits (14-10) from the page 
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requiremerfts in 1D6 , and adding the Em size in ID5 (13-4) - adding 
1 If the IhP was def eul ted-anc storing the result in DPORG. If the 
resulting page size <DPSIZ then ID segment wora 21 is updated as 
mentioned acove to reflect the partition assignment, otherwise 

a GEN ERF 50 results. 

12.6 KEKOHY PROTECT FENCE lABLE 

The 6 wora MFFT stored in a able Area II on the disk is updated to 
reflect the logical fence addresses for the following pioararo 
categories : ^ t ^ 

word type 4 EG disk resident without common 

1 memory resident 

2 any program using RT common 

3 any program using EG common 

4 any program using SSGA 

5 RT or type 3 BG disk resident without common 

TABLE 10 - hFF'r 



Table /^rea II entry point $DPL (load point for disc resident 
program) sets word 0. 

The variable FVw^;RP (first word of memory resident program) sets 
wo r o E , 

The variable RaCAD (real-time common address) sets word 2. 
ihe variable BGEND (background common address) sets word 3 
The variable SSGA. (SSGA starting address) sets word 4. ' 

' sets' word^!''*'"^ ^''''''^ ^^^^ ^^°'*^ ^"^'"^^ ^"^^ privileged programs) 

Table /^rea II entry point $MPFT will contain the address of the HPFT. 
12.7 MEMORY RESIDENT FPOGEAM ^;AF 

The E^■E map for memory resident programs, Kimp storec on the disc in 
id--ii, t,ree .11, ic uoceted fcr use by the Eisnatcher. -be ^Rl.p 
aaoressec by aaolc Area II entry point SMRKP, is 32 words lona'havira 
one wcro ner physical register. The map is built as follows? ^ 
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ry resident fccse paqe FP^oBP . 

ent library is converted to 

cred in FPHIL. Vt/crds 1 thru 

col ar'd physical page addresses, 

ver Prea and TabJ.e Area II are to 

b e n t hi e i r pages are w r i te - pro t e c t e d . 

occupied by the memory resident 

cs FVKhh thru (FP?''Fr. + PFFGF-1) 

g physical pages, MEBF+1 thru 

FPfSF+l to FFl^^iFF-1) are always 

p words (FPMI'F+FFPGF) thru 31 are set 

a CO r r e sp en d s to t he 1 on i c a 1 

idcnt area and 'each page is therefore 

5 and 14 are set in its HFMP entry) . 



12.b SETTI1NC- FY STEP FPIFY PC I PI ^: 



Crucial values are passed to the system trcm the generator. This 
is done by stuffing values into locations defined as entry points 
in Table Area II. The code to update these values on disc is 
table-driven, with a table entry consisting of these 5 words: 

label OFF *+2 

< value to oe stored> 
ASC 3,<entry point name> 



or 



DEC 



(last entry) 



Before updating the entry points, the values in the table are 
filled in. The following entry point values are set as indicated 
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^KBFP, meinory address ci m£.ii\cry resident iriap 

$tl^irs, physical page follcv/ing £A^;#1 

^.y:P:1A, .memory address oi memory allocation table 

$^:l■ Si^: , # pages/starting page oi SA^#1 

$MPS2, # pages/starting page of SA^■fr2 

$MPFi , memory address of memory protect fence table 

9ITFR, yiPT entry address of real-time free list Keader 

$ECFH, KI\1 entry address of background free list header 

v'C F F , F ^ T entry ad d r e s s of c h a i n e d free 1 i s t h e a d e r 

$!;f''RT, last were address of iriemcry resident program area 

fCVKF, TTie/Tiory address of Driver Hap Table 

vFVPT, logical starting page of driver partition 

$LTTB, nuraber of pages per driver partition 

$f ^rp, TTiaximum number cf partitions 

^?'Chi.N, page size of largest rvother partition 

$^■BC^, nage size of largest background partition 

$i^^FTP, page size of largest real-time partition 

$ID}X, meirory address cf ID extension table 

$rLF, load point address for R1/EG DF programs v/ithout conim.on 

$PLP, load point address for privileged FF programs 

^I.FivC, last word +1 address of memory resident library 

$FLI-C, negative lower Duffer limit 

$ELi-jI, negative upper buffer limit 

v^hen done setting the above values there are six values to be stored 
in the following table (for use by the configurator): 

starting at $SBTE: disc address cf driver partitions #2 onward 

# cf pages for driver partitions #2 onward 
disc address of memory resident base page 
i» of pages for memory resident base page 
disc address of memory resident lib/programs 
if of pages for memory resident lib/programs 
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13.0 EPROE PPCCESSING 

cpf' rrp^f ?.-''°'" ^'^^^ '=^^"9 accessed through FMP calls, and 

errnn^o.c "^"^^^"^ from an illegal generator response or aA 
InZpTrrTt^^^^" ''^^^^'^^ "^"^"^ ^^^ 9eneration. In most cases 
lor the mmLr^f """"^^ ^ °^'' "'^°'^ " "^^l- '^ c°""t ERCNT is klpt 
dlL^^vJ =f ^ K f^""'"'^ occurring during a generation, and is 
displayed after both normal and abortive generator termination.^ 
in the form: xxxx ERRORS yenerator terminations, 

^RCHrwith'^-TrrM-^^/f^^^"^ P\''^^ ^° *^^ operator console by calling 
operator console'ERRrrn. '" '^''^ '"^^ butter, LU being the lu of thi 

llZTntir. ^^t^^n[^,^'^'^ '- -^" "turn th^m to tL n^ext 

List file errors encountered after the list file has been crpat^ri 
are aetected in /LOUT. The error that occursmost frequentlv 
results when an extent to the list file cannot Sfcrealed due to 

occur nvtiLT^" °" ^'"^ """" subchannel. Because this error can 
occur crytime during generation, the status of the inDut/outcnt 
buffers LBOF and TBUF must be maintained as they may contain 
unrr^^^ ^' °' ^''^"^"^e code. The FMP and GEN erroL ?epSrted 

FXEC cari°Sriter'%n.'i' 'jf '"" «-r are therefore, issued via 
t^ 1^ ^ M' • (Using the normal error reporting routines 

workn^The user'i/:r'"^' "^'^ *° /"^"""^ " ^^' recursion doLn't 
worK!) The user is the prompted with an "OK TO COKTTNnp?" nr, =. mo 

[pp?p"'' '^^ generator aborts via \TERM call. On a YES response 
LFEPR IS cleared to inriiVptfe* 4-H;a4- =,i i *: i. -. . a ±1^0 ie&ponse, 

v,.i.^ai.c:u L.VJ xnaicate triat all future li«?t- fii*a csrrrwc^ 

t^'V^^Vl^^'^i^ t^^/lJ-"-^^- -e BCH^^ o^^iLr^ust then 

13.1 GENERATION EFRCEE 

\GKER outputs all errors of the form "GEN ERE XX" where XX jb ^h^ 
two digit Ascii error cede passed in the fl-real^ter rf ^k a 
register is negative, then it implies that we^have ^n error tC^e 
P^t^inlo'^dupricat''' '"'" '^ '" '^^ <^°"^ (thesrccdertypic^Hy 

p^^? \^F^ir?^^LlLm!L^^rc^5;t^^^/°^"^^';e ?r\^-?^rrerf t^h^e^^^^ 

calUnrTRCHr'';hi%?a'°.n^^L^^^^^^'°"^ the ret'urn address^when 
calling IKCHK. The flag EOFFL is set in \PRMT to signal that an 
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IGF had been encountered in the arsv/er file. Thus when the FOP 
is done on the answer tile stack cnly to fine nothincj there, a 
GLN EhP 19 will not be printed - control will siiPply be 
transferred to the console as intended. Since calling \GNER is 
the realization of an actual error, it is up to the caller to 
take corrective action. 

13.2 FILE tFFGFS 

All FMP errors are detected and processed in the routine \CF1L. \CFIL 
is called after each FU^ call is made (i.e., all READF ,V:RITF ,C"1 AT, 
'close, OPEN, LOCF,APCSP and PKKCF calls) and checks the error 
oararoeter \B'MFP. CNUMD is callea to convert the error code to Ascii 
and stuff it into the message "FhP EPE-KX FLNAME'* . The DCB address 
is passed to \CF1L in the A-Peg . Frcm the DCB words and 1, the 
file directory entry address or the lu is retrieved. An EXEC call 
read is done to that track and sector and the file name is transferred 
from words 0-2 of the directcry entry to the error message buffer. 
If word of the DCB is then it was a type file and the file 
name in the error message is set to the lu, "LU XX". Fince \CFIL_ issues 
error messages, an error can occur on an CtEN or CHEAT call in which 
case the DCE is not set up correctly. Therefore if the A-Reg DCB 
address is zero indicating a check following an OPEN or CKEAT 
call, then the file name is picked up from PARS2+1 , +2 ,+3 since it 
always contains the file to be opereo. An error never occurs on 
the OPEN/CFE:at of a type file since the generator routine TYPO 
builds the actual DCB, so this combination is not encountered. 

\CFIL also determines whether or not a transfer of control to the 
operator is necessary, in which case TRCHK is done. Some return 
addresses are saved and restored in case it was TRCHK who originally 
called \CFIL. \CFIL has two returns with the error return being 
at (P+1). It is up to the caller of \CFIL to determine the course of 
action when a file error occured. 

13.3 AECKIIVE TERMINATION 
13.3.1 \ABOR 

\Ab(l issues its own error of the form "CEN ERR 00 XXXXX" where 
XXXXX is the octal address of the caller of \ABCR. Because \ABOR 
is called from several places, the address helps in tracing down 
the problem. After outputtinq the message, \TERM is called for 
clean-up before termination. The abort may result if there exists a 
oroblem with the generator's LST,1DENT, or FIXUP table or its 
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scratch file (C^§^^-^?A) - such that an entry is no longer there. 

Ihe loss of a table ertry would result from an imcomplete disc 

swap of a table block - this could be an actual generator problem 

or It coula be a hardware problem. Past experience recommends 

one to check the hardware first on all GEN ERR 00 's. Obviously 

this error should never occur - so only strange conditions will cause 



e 

purged 
t file, 
he abort 



It. 

-» 
13.3.2 \TERM 

\TLEM is called when the operator aborts the generator wit-h a '1 
command, when a GEN ERR 00, 02, 07, 17, 18, 2i, 38, 57, 59, eo) 61 
Shc!^^:!-'''' .^^l !H^ errors to \MDCB , \EDCB, \RDCE , \IDCB OR \ADCB . Th 

iusina I cr^ocr' 'li''-^K^' '''" ""' modified Nam record file are puraed 
(using a CLOSE call with truncate option), and the lis 
relocatable input file, and answer file are closed. T 
message is printed, the generator releases the scratch tracks 
allocated to it, and the generator terminates. 

13.4 MISC. ERROR PROCESSORS 

\INER and \IREE 

\INER is called from several places in the main and segments 1, 
D ana / to issue the initialization response error GEN ERR 01 
It merely calls \GNER where the transfer of control is done to 
the console. The caller of \INER then reissues the questions for 
the corrected response from the operator. 

\IREE calls \GNER for the irrecoverable errors 07, 12 and 21 
followed by a call to \TERM to perform clean-up and abortion! 

NROOM and CF-ER 

NROOM issues errors 02 (not enough space for tables, 512 word 
minimum) and 38 (ID segment of segment 3 cannot be found) by 
calling \GNER, then aborts the generation with a \TERM cali: 

PhfL^!! Segment 2 issues a GEN ERR 06 when an invalid Program Input 
fnf.^^r^ T^ entered, or when an FMP ERR-XX FNAME occurred on a 
neit command! '" " RELOCATE command. NXTCM then prompts (-) for ?he 



^ 
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13.5 L:RRGE SUSPENSIOINC 

The generator detects tvvo errcr conciitions which result in a 
meesage sent to the ccnscle (cn]y) and the suspension of the 
generator until the situation is resolved. When the generator 
requests its 6 scratcK; tracks anc' they are not available, then 
it issues the message "GIHEF/'TOR i/vAIIIMG FOR TRACKS", and reissues 
the E>EC 4 call with the wait bit set. The same sequence of 
operation occurs when an attempt is made to lock the list file 
(provided it was to a non-interactive lu) where "GENERATOR V'/AITING 
ON EIST LU LOCK" is displayed on the console. 



13.6 AWSVjER file effort 

Vvhen doing transfers wit 
done for PUGh/POP errors 
underflow, a GEF ERF 19 
PUSHR, resulting frcin TR 
decreirented by one to pc 
current since the PUSH w 
pops the stack to the pr 
to be done on return in 
on a PUSH, at TF3 RE GOV 
the same holds true at T 
file, only here v/e have 
called . 



hin '.iRCRK, special processing must be 

At PCPRR, which results from TR stack 
is issued with a forced "TF,ERRLD". At 

stcxk overflow, the stack address is 
int tc word 6 if the previous entry (actually 
as never done) and RECOV is called. RECOV 
evicuE entry, thus enabling a "TR,ERRLU" 
some cases. When an invalid lu was specified 
is again called before issuing the GEN ERR 20; 
R4 when an error occurred on the new input 
to save the error code while RECOV is being 



Viher> an invalid lu or file was specif ico in the turn-on parameters, 

STRT2 issues its own errors rather than call \GNEF or \CFIL before 

the answer file and I/'COF have been established. 

the operator console has beer detern ined 

of that lu is stored in the "TF,>'X" message tc be used later with 

al 1 " 7 R , E RRLU " calls to 1 RCH K . 



Once the lu of 
(default is 1) the Ascii 



13.7 EFIVrp PARTITION GVEPFLC^v 



When riultiple orivers are being relocated into a driver partition and a 
driver overflows the logical rr^erory space reserved for the DP, a warning 

niessaqc of the torm: 

' E K I V E R PA FT 1 1. 1 N V L Ri EG W ' 



is issued. This does net constitute an error condition and no TR,ERRLU 
is: cione. The message is infcrmativ( only, essentially telling the user 
to ignore the load map printed for the driver just relocated. That 
driver will be re-relocated into a subsequent driver partition. 
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APPENDIX A 



DISC LAYOUT OF AN RTE-IV SYSTEM 



FIGURE C-1 DIAGRAMS THE ALLOCATION OF DISC SPACE 
BY RT4GN WHEN IT CREATES AN RTE-IV SYSTEM. 
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A 
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• TABLE AREA II 
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APPENDIX B. RTE-IV SYSTEM DISC LAYOUT 



DSCUT 



DSCLB 



SYSLN 



Disc 
Resident 
Relocatable 
Library 




.-^„ <::. 



all type 6,7,^ 14 
programs 



type 0316 
modules 
entry points 



User- 
Available 
System 
Entry 
Points 




nd of system 



Free Track Area 



track boundary 



type 13,15 % 30 
modules 
entry points; 
all ABS,RP, 
COMMON, entry 
points 



all type 6,7, 
§ 14 modules 
entry points 



t 



1 



LIBRARY ENTRY POINTS LIST 



NOTE: SYSLN § DSCLN 
contain the 
number of 4 -word 
entries 



FORMAT: word 


1 


name 1,2 


word 


2 


name 3,4 


word 


3 


name 5, flag bits 


word 


4 


value 


flag bits: 






000 




memory resident 


001 




disc resident 


010 




common 


Oil 




absolute 


100 




replace 



A sector boundaries 
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A nuwber of changes have been Mode to the modules that interface 
to M T M and several new s y s t e n library routines hove been created. 
The new system library routines yere sufficiently discussed in 
the HTM ERS. This section discusses the changes to the scheduler. 
MESSS/ and the flow of control between PR MPT and R*PH$. 



SCHEDULER 

Two changes have been Made in the scheduler. The first is in the 
$TYPE routine, the second is the progronnatic schedule request 
<E){EC 9. 10/ 23 and 24) at $MPTS. 

$TVPE accepts operator connands and is the system console's 
interface* to *HESS which processes these co.Mwands. «TYPE now 
screens the operator input coNwands for 'OH' or 'RU'. If either 
of these connands were entered and were successful, then 
session word 3 < I D segment word 32:» will have a -I placed in it. 



Session word 3 will be used two ways. If the siqn bit is clear 

the proqraM is in the session Mode. If the sign ^.. .- - 

LU nunber of the console at which the 
• -I in the word 



the sign bit 
i <; in the ses='"" m r. n •? it one si an bit is set/ the 
the word has the negative 

program was scheduled. Thus $TYPE places a 

neaning that the progran is not in session and was scheduled at 
L U I . 



Another change in the scheduler was wade at $MPT5 which handles 
EXET srhedule requests. Processing was added to propagate session 
word 3 froM father to son. The father was scheduled fron and thus which 
LU to issue messages to. 



tIESSS 

MESSS is a systeM library routine thot allows users to interface 
to $MESS in the scheduler. MESSS is used by nony prograws to 
schedule progrcns when the 'ON' or'RU' coMnand is issued at an 
MTH ternlnal. liESSS now performs the sawe operation as *TYPE/ that 
is^ if the 'ON' or ' RU ' was entered and was successful <no 
returned message froM $MESS) then the prograw to be scheduled will 
have its session word 3 set to the negotive MTH LU nuMber. 

PR HPT - R$PN1i 



PRNPT and R*PN*. 
This Means that 



PRMPT is a 
PR HPT nust 



The guts of HTM is really two program S;^ 

prog ran that is scheduled by interrupt ^ .^^u,,* vnuv rrsnri r, u» 

be relocated at generation tiwe and then one entry XK.PRG/PRHPT be 
wade in the Interrupt Table phase of generation for every select 
code address, XX / where the user wishes HTM terminal hondling. 



PRHPT is the progran that issues the XK> pronpt and issues a class 
I/O read on the terminal . RIPN$ does the class get and handles any 
input typed into the terminal. The one exception to this is for MTH 
scheduling a copy of FMGR. This is PRMPT's responsibility. 

The flow of control in MTM actually storts before the interrupt. As 
foentioned PRHPT must beset up at generation tine. The terminal 
Must also be enabled before MTM will do any processing. Typicallu 
a terminal is enabled with the '• CH , LU#.. 2<iBconmand. It mau be 
disabled with the ;CN, LU#.. 216 command. 



Enobtinq the 
address into 



t e r n i n Q I allows the driver to place P R M P T ' s ID 
the associated EQT. The driver taU-es the ID 

' s ) c o H p I e r-i e n t 



i n 



address out of the interrupt table <)t's 

forn) and ploces it into q tenporary word in the EQT or EOT 
e>; tension <as a positive address J. The interrupt table entry 
is then replaced with the first yord address of the 
rQ\^srfsnc^6 EQT. HTH is now ready to handle the terminal. 

An interrupt froM the CRT <TTY) device is generated by 
hitting any M e y . $ C I C in R T I C is entered and sectors the 
interrupt to the appropriate driver. The driver then 
determines if the terminal is enabled., if not the interrupt is 
ignored. If the terminjal is enabled/ the driver schedules PRMPT 
via the system routine i?LIi)T and passes the address of the fourth 
word of the a p p r o p r i a t e E Q T . 

P R H P T 



PRHPT takes the address of word four of the EQT and calls TRMLU. 
TRHLU is a new system library routine. Its responsibility is to 
Match up the EQT oddress to an interactive LU nunber. This is 
done by comparing the passed EQT address to the contents ai" the 
device reference table <DRT). Recall that the lower six bits of the 
DRT has the ordinal nuwber of the EQT associated with that LU. 
TRHLU also Misures that the LU nunber returned is an 
interactive L U . This is done by c h e c l-: i n g for driver type, I f t h e 
driver is D V I? , D V R 5 and subchannel zero., or D V R 7 then the 
device is interactive 



When TRHLU returns PRMPT has both the LU nupiber and the EQT. 
are {^ a d e to insure that the EQT and L U are up. The a v a . I a b 

sign bit is checked in part 



bits are checked in the EQT and the 
of the DRT to insure that the L U is 
if the CRT L U is 1 o c c k e d If the L U 
will have the resource number ( R H « ) 
zero/ then the LU is locked. 



C h e c k 3 
. ty 



bit is checked in part two 
up. A check is also «ade to see 
is locked bits 10-5 of the DRT 
of the lock. If that field is non 



It is possible to write through on LU lock. Pararieter nine <RQP9.) 
of all I/O EXEC requests has been reserved as an LU lock bypass word. 
Thewordisconfiguredas." 



I 5 

\ RH# owner 



RH« froM DRT 



be retrieved by inde.xing into the RN# Table 
lower byte. If the above word is configured an 
in R9Pg., then the systen will not suspend the 
executing p r o g r a n and will honor the I/O request. 



The 


RN# owner can 


and 


isolating the 


DEF 


is n a d e to it 



Next a check is wade to 

XX>FHGXX is sent to the 

list deviceset to XX. 

pass feature to send FHGXX to the HI f i I© 

transferred to the terninal. Lastly PRMPT reenobles the terminal 

and terninatessaving resources. 



see if a FHGXX exists^ if so the prompt 
ternindl and FMGJ<X is scheduled with the 
The schedule request uses the string 

before control is 



If FHGXX does not exist or is busy, then the pronpt XX> is issued. 
a cUss read is perforwed on terminal LU XK, R$PN$ is scheduled 
passing the class number. In the case of DVROO and DVR05/ the 
terminal is disabled to avoid nutiplepronpts fron being written. 
For DVR<i7/ an edit wode control request is mode. 



PRHPT does perforw one other tiisU . After the very first successful 
class read/ which also requests the class nu «ber/ PRHPT soves the 
returned class nuwber in *MTM in Table Area I. This insures that 
aborts of PRHPT or RfPHI do not also lose the class nuwber. 

R $ P N * 

R«PN« is the HTM nodule that does class gets with wait. That \ s , 

it receives all input to the terninal, screens it. and passes it on 

to the operating systew via direct coll to the opera t » ng sysien routine 

$ N E S S . 



When R$PN$ is first scheduled, it picks up the 
tracks down the ID address of FNGR/ SHP/ and D 



class number and 
RTR for later use 



RliPNI then performs a class get to get the input data. This 
get is p e r i*' r f T e d over o n d over ci q a i r? so that R^PH$ \ s always 
q e t suspended. 



The s y s t e M r e s c h e d <.< I e s R $ P N 4 whenever there are any input 
operator conisands to process. RIPHf/ on reschedule perforNS 
the safie EQT. LU , and L(J locU checMs as does PRHPT. If I/O to the 
CRT is possible/ execution continues. If the E Q T or L U is d o w n - 
the request is ignored GndR*PN$ goes back to the class get to 
5 u 3 p e n d i t s e I f ■ . 



If I/O is possible t h e n ; t h r e e c o h m a n d s are screened, 

F L c n f \ a n d £ are h a n d I e d I o c a I I y in R $ P H * . H o w e v e r / 

exists only the FL cowwand ishonored. In this case 
are just passed on to the systew. 



BR/ fIB / and 
f no FMGXX 
BR end AB 



If the input conn and was not f^B.. BR/ or FL/ then the connand is 
sent to the operating system r-n o d ii I e $ H E 3 S . When $ M E S S returns any 
p! e s 3 a g e s returned f r o r the s y s t e « are set to terminal XX with a 
class write call. This insures buffered writes to unbuffered 
devices. Lastly., the t e r o) i n a I is r e e n a b "l e d if the driver was 
D V R or D V R <i 5 and a class get is performed so that R $ P N $ nay 
s u s p e n d i 1 5 e I f . 



HOTE that R$FN* 
information and 



does class gets to 
PR MPT' 3 class read 



retrieve its 
inforNation. 



own class write 



AbSEIibLEK 



2. Introduction 



ihere are two major changes ir^aoe in the KlE-Asserr^bler . A pseuao 
opcooe Li^.A was added to the assrcebler . This opcode allows the 
user to declare an external memory array. i^ext, I/O from and to 
Lb/LC areas is replacea by 1/0 from and to file ii.anao^r (IIps 
u:.),rij u,t compiler library. List output can also be^oirected 
to a file manager file. ihe cross-reference generator XREF is 
also cnangeo to go file I/O. 
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3a. LT A FEGUcc Opccc'e 

irie Lt A instruction is cetinec as: 

Label L^iA t.LA size, MSEC Size, 



3 
4 

5 
6 

I 8 
I 9 
10 
11 
12 
13 
14 
15 
16 

E^lA is assiqneQ 5 as an opccde ioentitier. In pass 1 of the 17 

assembler, the processing for the lIA instruction is acne in 18 

the bt'iP processor. here tiiCi.'x flag is checked to deteririne if 19 

it is 0.^ it this flag is non-zero, then another EMA instruction 20 

was encountereo previously. bince only one EMA instruction per 21 

progrerr. is allON^eo, an 'iL', illegal instruction error message 22 

is printed for the second 'eI'-a' instruction encountered. The 23 

CHOP routine is called next: to evaluate the two operand values. 24 

E('iP checks to nake sure the; two values returnee by CHOP are 25 

absolute, a 'uim' - uncefined symbol error is printed otherwise. 26 

The ERA size must be positive ana less than 1024. The MSEC size 27 

must be positive, less than EiJA size (unless EMA size is 0)^and 28 

less than 32. It any of the above conditicns are not met, 'k'- 29 

Illegal operano error is printed. An ELA instruction must have 30 

a label. Xi a laLel is not present an "Lb\ label not present 31 

error message is prmtec. The syn.Loi type assignee to the Ei4A label 32 

is 4 - the same as that for an external symbol. The undefined 33 

bit, bit 15 ot woru i of the symool table entry is set to 34 

distinguish between an external symbol anc an EMA label whenever 35 

necessary. The label for an EQu to EMA label is given the sym.bol 36 

type 5 with the unaefinec oit set. The starting address of the 37 

external memory array is the beginning of the first page in free 38 

available mem.ory anc can be defined only at load time. 39 

40 

Tne assemibler creates a special V-woro EMA binary record with 41 

the record identification numiber as 6. Refer to the RTE mianual for 42 

a description of the EMA binary record. This binary record is 43 

set up and output at the beginning of pass 2, just after all the 44 

EXT binary records are output. "ihe relocation indicators in the 45 

DBL records for instructions using EMA label are: 4 for instructions 46 

using EMA label ana 5 for EMA label with offset. The assem.bler 47 

does not make a distinction between EXT and EMA symbols while 48 

processing the n.emory reference instructions. 49 

50 

51 

52 

53 

54 

55 

56 

57 

j ! 58 

i ! 59 

|_^ _ _! 60 
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APPElMDiX: 

utCULL Table irormat: 

Each entry has the following format 



i 1st ChAK j 2nd ChAR | 
I , _ , 

! 3ra CiiAR | Cuub I 

|. _^ 

I li:>ibTRuCTION FORMAT | 



'^^^^f^i^^?!?^ ?r^^ (8-bit) identifiers used to F;rccess the OPCODE 
or 



,,,,,. . r -' y ^'^^' -'■^'^it^j-i.ici.t, ust^u tu process tne OPCO 

curing assen>Diy. Instruction Format is the instruction format 
Dr the location of the processor for the opcode. 



SYhBOL TAi:>LE 
Contains: 

a. Labels 

b. External symbols 

c. COMMOiM names 



15 


14 



1 13 i 12 i 11 
j I 1 


10 j 9 1 8 

i 1 


1 7 


1 6 
1 


5 1 4 
1 j 


i 3 1 


2 


1 





lu 
1 




WORDS 


i 

1 E I 

1 


1 -.«--. j ».«.^ 
TYPE 






1st 


CHAR 












2nd 


CEAR 








3rd 


CHAR 












4 th 


CRAR 








5 th 


CHAR 








j VALUE j 
1 __^ 1 
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U == uncle finec bit: 



= Symbol detined 

1 = Syiibol undefined or LMA (symbol 

type 4 or 5) 



WORDS = ixiurnber of v/crds in entry (2-4) 
E = Entry point bit: 



TYPE = Symool Type: 



1 = byir;bol has been declared an entry 
point 

= i.JOt an entry point 

G = Absolute 

1 = Relocatable 

2 = Base Page Relocatable 

3 = <^UMMLiL4 name 

4 = External or EMA 

5 = babel equated to External symbol 

or EMA label 

6 = Code replacement (EiMT) 
i = Literal 



VALUE = Symbol value: 

a. Absolute value (type 0) 

Value relative to relocation base for types 1, 2, 3 
External or EMA symbol ordinal (types 4, 5) 

b. Tne value will contain the location of the literal relative 
to the end of the main program at object tim.e. 
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3 
4 
5 
6 

Is 
8 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 
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